{ "openapi": "3.0.1", "info": { "title": "Yandex Maps Reviews Scraper: Парсер отзывов Яндекс Карт, Alerts", "description": "Scrape Yandex Maps reviews (отзывы Яндекс Карт) for any business: stars, full text, photos, owner replies, likes and reviewer levels. Schedule it to get only new reviews, rating changes and unanswered ones. Filter by stars, date or reply. JSON, CSV, Excel. No login.", "version": "0.3", "x-build-id": "NiHNuuXSGQyRPgy7I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~yandex-maps-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-yandex-maps-review-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/getascraper~yandex-maps-review-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-yandex-maps-review-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/getascraper~yandex-maps-review-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-yandex-maps-review-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "businessIds": { "title": "Business IDs or links", "type": "array", "description": "Yandex Maps business IDs or full business links. The ID is the number in the page address: /maps/org///.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Yandex Maps business page links. The business ID is read from each link.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "onlyNewReviews": { "title": "Only new reviews (monitor mode)", "type": "boolean", "description": "On: return only reviews not reported in an earlier run, so a scheduled run is a change alert. Off: return every review in scope on every run.", "default": true }, "reportNewOwnerReplies": { "title": "Also report new owner replies", "type": "boolean", "description": "In monitor mode, also return a review again when the business owner has replied to it since the last run. Each such row has changeType owner_reply_added.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include reviews with this star rating or higher. 0 = no filter.", "default": 0 }, "maxRating": { "title": "Maximum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include reviews with this star rating or lower. 0 = no filter. Use 1 or 2 for complaint alerts.", "default": 0 }, "dateFrom": { "title": "Reviews since", "type": "string", "description": "Only include reviews from this date on, for example 2026-01-31, or a period such as 30 days, 4 weeks or 6 months. Leave empty for all dates." }, "replyFilter": { "title": "Owner reply", "enum": [ "any", "replied", "unanswered" ], "type": "string", "description": "Pick unanswered to build a list of reviews the business still needs to respond to.", "default": "any" }, "onlyWithText": { "title": "Only reviews with text", "type": "boolean", "description": "Skip star-only ratings that carry no written review.", "default": false }, "maxReviewsPerPlace": { "title": "Max reviews per business", "minimum": 0, "type": "integer", "description": "Look at this many reviews per business, counted after sorting (newest first by default). 0 = all reviews.", "default": 0 }, "sortBy": { "title": "Sort reviews by", "enum": [ "newest", "oldest", "highest", "lowest", "relevance" ], "type": "string", "description": "Order of the reviews. It also decides which reviews count when you set a maximum.", "default": "newest" }, "language": { "title": "Language of business details", "enum": [ "en", "ru", "tr", "kk", "uk", "be", "uz" ], "type": "string", "description": "Language of business names, addresses, categories and reviewer levels. Review text always stays in the language it was written in.", "default": "en" }, "includeReviewerData": { "title": "Include reviewer profile data", "type": "boolean", "description": "Off: reviewer name, profile link, avatar and level are left out of the output.", "default": true }, "includePhotos": { "title": "Include review photos", "type": "boolean", "description": "Add links to the photos attached to each review.", "default": true }, "includeTranslations": { "title": "Include Yandex translations", "type": "boolean", "description": "Add the translations of the review text that Yandex shows, when available.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The default proxy works for normal runs. If the default is blocked, the Actor retries on residential IPs by itself when your plan includes them.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }