{ "openapi": "3.0.1", "info": { "title": "Yandex Maps Reviews Scraper", "description": "Scrape public Yandex Maps (Яндекс Карты) place reviews by org URL or business ID, with author, rating, text, date, photos and business replies. For place search, use Yandex Maps Scraper.", "version": "0.1", "x-build-id": "LRFWaovWwuJgNKLul" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~yandex-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-yandex-maps-reviews-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/khadinakbar~yandex-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-yandex-maps-reviews-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/khadinakbar~yandex-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-yandex-maps-reviews-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": { "startUrls": { "title": "Yandex Maps place URLs", "type": "array", "description": "Yandex Maps organization URLs to scrape reviews from. Accepts https://yandex.com/maps/org/{name}/{id}/reviews/ and maps.yandex.ru org links. Up to 50 unique places per run after dedupe. NOT a place-search query — for discovery use yandex-maps-scraper.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "businessIds": { "title": "Business / org IDs", "type": "array", "description": "Numeric Yandex organization IDs when you already have them (for example 1036014863). Combined with startUrls and deduped by ID. Use this for batch jobs from yandex-maps-scraper output. Invalid non-numeric values are skipped.", "items": { "type": "string" }, "default": [] }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper bound of reviews to save per place. Defaults to 50 (one SSR page). Prefill 5 keeps quality tests fast and cheap. Maximum 2000. Each saved review costs $0.004.", "default": 50 }, "maxPlaces": { "title": "Max places per run", "minimum": 1, "maximum": 50, "type": "integer", "description": "Hard cap on unique places processed after URL/ID dedupe. Defaults to 50. Lower this to bound spend when pasting long URL lists.", "default": 50 }, "reviewSort": { "title": "Sort reviews by", "enum": [ "relevance", "newest", "highest", "lowest" ], "type": "string", "description": "Preferred review order. Yandex SSR pages are relevance-ordered; newest/highest/lowest re-sort the fetched window locally by updatedTime or rating. Prefer relevance for faithful Yandex order.", "default": "relevance" }, "minRating": { "title": "Minimum star rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Keep only reviews with this star rating or higher (1–5). Leave at 0 to include all ratings. Applied after fetch; may reduce billed rows below maxReviewsPerPlace.", "default": 0 }, "maxRating": { "title": "Maximum star rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Keep only reviews with this star rating or lower (1–5). Leave at 0 to include all ratings. Useful for complaint mining (set maxRating to 2).", "default": 0 }, "includePhotos": { "title": "Include photo URLs", "type": "boolean", "description": "When true, attach public review photo URL templates (size resolved to orig). Defaults to true. Set false for smaller rows when you only need text and ratings.", "default": true }, "language": { "title": "Yandex domain language", "enum": [ "en", "ru", "tr" ], "type": "string", "description": "Chooses the default Yandex host for bare business IDs: en→yandex.com, ru→yandex.ru, tr→yandex.com.tr. Place URLs keep their own host. Does not translate review text.", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy. Direct Impit Chrome-TLS usually works. Enable Apify Residential (RU preferred) if SmartCaptcha or HTTP 403 appears in cloud runs. This is not a Yandex account session." } } }, "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 } } } } } } } } } }