{ "openapi": "3.0.1", "info": { "title": "Yandex Maps Scraper Яндекс Карты [Only $3] Phones & Websites", "description": "[$3 per 1000 places, +$0.50 with a phone] Scrape Yandex Maps (Яндекс Карты) with no login: name, phones, website, social links, rating and reviews count, categories, address, coordinates, hours and metro. Any query in any city in Russia, Turkey or the CIS, or paste map links. JSON, CSV, Excel.", "version": "0.0", "x-build-id": "uPmc02n2qrm5v6OFj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~yandex-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~yandex-maps-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~yandex-maps-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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 queries", "type": "array", "description": "What to search for, as you would type it on Yandex Maps: a business type, a category or a name, in Russian, English or Turkish. Each query is searched on its own in the location below.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or country to search in, e.g. \"Moscow\", \"Казань\", \"Istanbul\" or \"Almaty\". Empty means Moscow." }, "maxResultsPerQuery": { "title": "Max places per query", "minimum": 1, "maximum": 20000, "type": "integer", "description": "How many places to return for each query. One map view gives up to about 500; for more, the area is split into smaller parts automatically.", "default": 100 }, "startUrls": { "title": "Yandex Maps links", "type": "array", "description": "Search links (yandex.ru/maps/213/moscow/search/кафе/, with or without ll/z map position) business links (yandex.com/maps/org/name/1234567890/) or short share links (yandex.ru/maps/-/…). Any Yandex host works: .ru, .com, .com.tr, .kz, .by, .uz.", "items": { "type": "string" } }, "businessIds": { "title": "Business IDs", "type": "array", "description": "Yandex Maps business IDs, the number at the end of a business link.", "items": { "type": "string" } }, "language": { "title": "Language", "enum": [ "en", "ru", "tr", "uk", "kk" ], "type": "string", "description": "Language of names, addresses, categories and hours.", "default": "en" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Return only places rated at least this much (1 to 5). Empty means no filter." }, "onlyWithPhone": { "title": "Only places with a phone", "type": "boolean", "description": "Skip places that list no phone number. Skipped places are not charged.", "default": false }, "onlyWithWebsite": { "title": "Only places with a website", "type": "boolean", "description": "Skip places that list no website. Skipped places are not charged.", "default": false }, "enrichEmails": { "title": "Find emails on the website", "type": "boolean", "description": "For places that list a website, visit the site's contact pages and return the email addresses found there. Charged only where an email is found ($2 per 1,000), once per website: branches of a chain that share a site are charged once. Makes the run slower.", "default": false }, "maxItems": { "title": "Max places in total", "minimum": 1, "type": "integer", "description": "Stop the run after this many places across all queries and links.", "default": 1000 }, "proxy": { "title": "Proxy", "type": "object", "description": "Leave empty to use the built-in residential proxy. Set your own only if you need a specific exit." } } }, "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 } } } } } } } } } }