{ "openapi": "3.0.1", "info": { "title": "๐Ÿงช Yandex Maps Scraper โ€” Businesses by Area", "description": "Export organisations from Yandex Maps by name, category or address, centred anywhere in the world. Rows carry the rating with its two separate counts, phone numbers, websites, social links, opening hours, categories, amenities, nearby metro and coordinates.", "version": "0.1", "x-build-id": "RfHsMGjRTguo9kcxl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thenetaji~yandex-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thenetaji-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/thenetaji~yandex-maps-scraper/runs": { "post": { "operationId": "runs-sync-thenetaji-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/thenetaji~yandex-maps-scraper/run-sync": { "post": { "operationId": "run-sync-thenetaji-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search terms", "type": "array", "description": "What to search for, one per line. A term is never split on a comma, so a phrase with one in it stays a single search. Each term is run separately and every row names the term it answered.", "items": { "type": "string" } }, "latitude": { "title": "Centre latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Where to centre the map search. Send latitude and longitude together or neither: one without the other is silently ignored by Yandex, which then answers from its own default region โ€” measured, the term `coffee` with no centre at all returned a cafe in a small town in Krasnodar Krai." }, "longitude": { "title": "Centre longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "The other half of the centre. It is a field of its own rather than half of a pasted `lat,lon` string on purpose โ€” Yandex's own viewport parameter is longitude-first, and a transposed pair is how a search for New York quietly returns results in Somalia." }, "span": { "title": "Area size", "minimum": 0.0001, "maximum": 90, "type": "number", "description": "Half-width of the search area in degrees, applied to both axes. 0.05 is roughly a city centre. Leave it empty to let Yandex choose." }, "bounds": { "title": "Outside the area", "enum": [ "widen", "restrict" ], "type": "string", "description": "What to do with results outside the area. Widening is Yandex's own behaviour; restricting needs an area size to restrict to. Measured: a Red Square query with a New York area returns Moscow's Red Square when widening and nothing when restricting.", "default": "widen" }, "language": { "title": "Language", "enum": [ "en_US", "ru_RU", "tr_TR", "uk_UA" ], "type": "string", "description": "The language titles, addresses and opening hours come back in. This is a closed set: a locale outside it is refused upstream rather than falling back to a default, so offering more would be offering a failure.", "default": "en_US" }, "startPage": { "title": "Start page", "minimum": 0, "maximum": 100, "type": "integer", "description": "Which page to begin each term at, counted from 0, at up to 25 organisations a page. Useful for resuming a harvest.", "default": 0 }, "maxItems": { "title": "Max results per term", "minimum": 0, "type": "integer", "description": "Maximum organisations to save for each term. Set 0 for no limit โ€” the walk then continues until a page carries nothing new, which is the only honest end on this surface because the stated match count is an estimate that grows as you page.", "default": 100 } } }, "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 } } }, "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 } } } } } } } } } }