{ "openapi": "3.0.1", "info": { "title": "Yandex Maps Scraper - Places, Phones & Reviews, No Login", "description": "Exports Yandex Maps places by search or link: name, categories, address, coordinates, phones, website, social links, rating, review count, hours, features. Optional reviews with owner replies, up to 2,400 per place across four sort orders. Filters for phone, website, rating. No browser, no login.", "version": "1.0", "x-build-id": "9f3P8DxUgDa0H4O6l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~yandex-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-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/benthepythondev~yandex-maps-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-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/benthepythondev~yandex-maps-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-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": { "searchQueries": { "title": "Search terms", "type": "array", "description": "What to search on Yandex Maps, as you would type it there: 'кафе', 'dentist', 'автосервис'. Each term is one search. Add the place to the term or use Location.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City or area added to every search term, e.g. Moscow, Казань, Almaty, Istanbul. Leave empty when the terms already name a place." }, "startUrls": { "title": "Yandex Maps links", "type": "array", "description": "Search links (yandex.com/maps/.../search// or ?text=) and place links (yandex.ru/maps/org///). Place links return that place.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "businessIds": { "title": "Place ids", "type": "array", "description": "Yandex place ids, the number in a place link (e.g. 55760134248).", "items": { "type": "string" } }, "maxPlaces": { "title": "Max places per search", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Places saved per search term or search link. 0 means as many as Yandex lists (it lists a few hundred per search).", "default": 10 }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Reviews saved per place as their own rows. 0 for none. Yandex shows 600 per order; above 600 the Actor reads all four orders and keeps each review once (up to 2,400).", "default": 0 }, "reviewSort": { "title": "Review order", "enum": [ "newest", "relevance", "highest", "lowest" ], "type": "string", "description": "Order in which reviews are read.", "default": "newest" }, "language": { "title": "Language", "enum": [ "en", "ru", "tr", "uk", "kk", "uz" ], "type": "string", "description": "Language of categories, addresses, hours and feature names. Review texts stay in the language they were written in.", "default": "en" }, "onlyWithPhone": { "title": "Only places with a phone", "type": "boolean", "description": "Skip places without a phone number. Skipped places are not charged.", "default": false }, "onlyWithWebsite": { "title": "Only places with a website", "type": "boolean", "description": "Skip places without a website. Skipped places are not charged.", "default": false }, "minRating": { "title": "Minimum rating", "enum": [ "0", "3", "3.5", "4", "4.5" ], "type": "string", "description": "Skip places rated below this (0 keeps all, also unrated ones).", "default": "0" }, "minReviews": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Skip places with fewer reviews.", "default": 0 }, "debug": { "title": "Debug log", "type": "boolean", "description": "Log every request with its size and time.", "default": false } } }, "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 } } } } } } } } } }