{ "openapi": "3.0.1", "info": { "title": "Yandex Maps Reviews Scraper API | Парсер отзывов Яндекс Карт", "description": "Scrape Yandex Maps reviews (отзывы Яндекс Карт) for any place: star rating, full text, date, the business reply, photos and the author's display name, with the place name, address and rating on every row. Sort, date filter, optional search. No login. Pay per review.", "version": "0.1", "x-build-id": "rPJf4Z6TXJpm5Q3U9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~yandex-maps-reviews-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-yandex-maps-reviews-scraper-api", "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/themineworks~yandex-maps-reviews-scraper-api/runs": { "post": { "operationId": "runs-sync-themineworks-yandex-maps-reviews-scraper-api", "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/themineworks~yandex-maps-reviews-scraper-api/run-sync": { "post": { "operationId": "run-sync-themineworks-yandex-maps-reviews-scraper-api", "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": { "startUrls": { "title": "Places (links or business ids)", "type": "array", "description": "One Yandex Maps place per line: a place link (https://yandex.ru/maps/org/tanuki/1036014863/, yandex.com, yandex.kz and /reviews/ links all work), a link with oid=, a short link (yandex.ru/maps/-/...) or the numeric business id (1036014863). Up to 500 per run; the same place twice is read once. Leave empty if you use the search below.", "items": { "type": "string" } }, "searchQuery": { "title": "Or find places by search", "type": "string", "description": "Optional. A search such as кафе, стоматология or car wash. The actor finds places in the city below first, then reads their reviews. Works together with the list above." }, "city": { "title": "City for the search", "enum": [ "moscow", "spb", "novosibirsk", "yekaterinburg", "kazan", "nizhny", "chelyabinsk", "samara", "rostov", "ufa", "krasnoyarsk", "minsk", "almaty", "astana" ], "type": "string", "description": "Only used with a search. For another city, paste place links instead.", "default": "moscow" }, "maxPlaces": { "title": "Places from the search", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many places the search may add, nearest the city centre first.", "default": 10 }, "maxReviewsPerPlace": { "title": "Reviews per place", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Most reviews to return for each place. 0 means all the actor can reach. Yandex shows up to 600 reviews per sort order; above 600 the actor also reads the other sort orders and drops duplicates.", "default": 100 }, "sort": { "title": "Sort reviews by", "enum": [ "relevance", "newest", "lowest", "highest" ], "type": "string", "description": "The order Yandex returns reviews in. Lowest first is the quickest way to read complaints.", "default": "relevance" }, "reviewsStartDate": { "title": "Only reviews since", "type": "string", "description": "Optional. A date (2026-01-01) or a window (30 days, 6 months, 1 year). Reviews are then read newest first and reading stops at the first older review, so older reviews are neither returned nor charged." } } }, "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 } } } } } } } } } }