{ "openapi": "3.0.1", "info": { "title": "Yandex Search Scraper - Yandex Search API & SERP Results", "description": "Scrape Yandex search results into clean JSON rows: position, title, URL, domain and snippet for any query on yandex.ru, .com, .com.tr, .kz and .by, with region (lr) control, up to 25 pages, plus free related searches. For SEO and market research in Russia, Turkey and the CIS. Pay per result.", "version": "0.2", "x-build-id": "yYg7jh7rMRfjkRFd5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~yandex-serp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-yandex-serp", "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-serp/runs": { "post": { "operationId": "runs-sync-s-r-yandex-serp", "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-serp/run-sync": { "post": { "operationId": "run-sync-s-r-yandex-serp", "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": "Queries", "type": "array", "description": "Search queries as a list or one query per line. Blank entries are ignored; duplicate queries are retained. At most 1000 queries, each at most 400 characters.", "items": { "type": "string" } }, "domain": { "title": "Domain", "enum": [ "yandex.ru", "yandex.com", "yandex.com.tr", "yandex.kz", "yandex.by" ], "type": "string", "description": "Yandex market. Selects the default lr region, rather than guaranteeing a particular frontend: ru=225, com.tr=983, kz=159, by=149; com uses the visitor region unless region is supplied.", "default": "yandex.ru" }, "region": { "title": "Region", "minimum": 1, "maximum": 9007199254740991, "type": "integer", "description": "Positive Yandex lr region id overriding the market default: 213 Moscow, 2 Saint Petersburg, 11508 Istanbul, 10393 Almaty, 84 USA. Yandex can silently ignore unknown ids." }, "language": { "title": "Language", "type": "string", "description": "Optional lowercase two-letter language label, echoed in output only. It does not change the search language or ranking; query text and region determine the results." }, "pages": { "title": "Pages", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum pages per query. Stops earlier when Yandex has no more organic results. Large requests continue with next_cursor.", "default": 1 }, "include_related": { "title": "Include related", "type": "boolean", "description": "Include free related-query rows after the organic results of each query, only where Yandex displays them.", "default": true }, "cursor": { "title": "Cursor", "minLength": 1, "maxLength": 200000, "type": "string", "description": "Opaque next_cursor from the previous response. Keep every search option unchanged when continuing; omit for a new search." } } }, "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 } } } } } } } } } }