{ "openapi": "3.0.1", "info": { "title": "Yandex Maps Scraper | Парсер Яндекс Карт - Places & Reviews", "description": "Collect Yandex Maps business places, addresses, phones, websites, ratings and optional reviews for Russia, CIS markets and Turkey. Search by term and city, map region, coordinates, URL or organization ID, and export linked place and review rows.", "version": "0.1", "x-build-id": "QvBhD1pdDn2oVMkyT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~yandex-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-yandex-maps-scraper", "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/s-r~yandex-maps-scraper/runs": { "post": { "operationId": "runs-sync-s-r-yandex-maps-scraper", "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/s-r~yandex-maps-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-yandex-maps-scraper", "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": { "queries": { "title": "Queries", "type": "array", "description": "Business search terms. Add a city in the term, location, region_id or ll.", "items": { "type": "string" } }, "location": { "title": "Location", "maxLength": 300, "type": "string", "description": "City or region name resolved by Yandex to a map area for queries. Explicit ll and region_id take precedence." }, "region_id": { "title": "Region id", "minimum": 1, "maximum": 99999999, "type": "integer", "description": "Yandex Maps region ID, for example 213 for Moscow or 2 for Saint Petersburg." }, "ll": { "title": "Ll", "type": "string", "description": "Map center as longitude,latitude. Overrides region_id." }, "zoom": { "title": "Zoom", "minimum": 1, "maximum": 21, "type": "integer", "description": "Map zoom when ll is supplied, or an override for the region map area." }, "start_urls": { "title": "Start urls", "type": "array", "description": "Yandex Maps search or organization URLs, including organization review URLs.", "items": { "type": "string" } }, "place_ids": { "title": "Place ids", "type": "array", "description": "Numeric Yandex organization IDs. Each ID is validated through a place lookup before loading reviews.", "items": { "type": "string" } }, "max_places": { "title": "Max places", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique places per search. Yandex allows at most 1000 raw results; overlap can reduce the unique total.", "default": 100 }, "language": { "title": "Language", "enum": [ "ru", "en", "tr" ], "type": "string", "description": "Language sent to Yandex for place names, addresses and categories. Review text stays in its original language.", "default": "ru" }, "include_reviews": { "title": "Include reviews", "type": "boolean", "description": "Return reviews as separate rows alongside their places.", "default": false }, "max_reviews": { "title": "Max reviews", "minimum": 0, "maximum": 600, "type": "integer", "description": "Maximum unique reviews per place. Yandex exposes at most 600 per ranking.", "default": 20 }, "reviews_sort": { "title": "Reviews sort", "enum": [ "newest", "relevance", "rating_asc", "rating_desc" ], "type": "string", "description": "Review ranking: newest, relevance, lowest rating first or highest rating first.", "default": "newest" }, "cursor": { "title": "Cursor", "maxLength": 2000000, "type": "string", "description": "Opaque continuation token returned as next_cursor. Resubmit the same input with this token; valid for 24 hours." } } }, "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 } } } } } } } } } }