{ "openapi": "3.0.1", "info": { "title": "Yandex Search Engine Scraper (SERP API)", "description": "Scrape Yandex web search: rank, title, URL, displayed domain, snippet, sitelinks and result type (organic, ad, featured). Target any Yandex region by lr code - Moscow, Istanbul, Almaty, Minsk. No API key. At $3.40 per 1,000 results it is the lowest-priced established Yandex SERP scraper on Apify.", "version": "0.1", "x-build-id": "DAZT81lj4MLUcY0un" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~yandex-search-engine-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-yandex-search-engine-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/dami_studio~yandex-search-engine-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-yandex-search-engine-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/dami_studio~yandex-search-engine-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-yandex-search-engine-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": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords to search on Yandex. One row per result. Works in any language — Russian, Turkish, English, Kazakh.", "items": { "type": "string" } }, "startUrls": { "title": "Yandex search URLs", "type": "array", "description": "Paste full Yandex search URLs instead of keywords, for example https://yandex.com/search/?text=pizza&lr=213. The query, region and start page are read from the URL.", "items": { "type": "string" } }, "region": { "title": "Region (Yandex lr code)", "type": "integer", "description": "Yandex region id that decides which regional ranking you get. Verified codes: 225 Russia, 213 Moscow, 2 Saint Petersburg, 65 Novosibirsk, 54 Yekaterinburg, 43 Kazan, 47 Nizhny Novgorod, 39 Rostov-on-Don, 35 Krasnodar, 51 Samara, 187 Ukraine, 143 Kyiv, 149 Belarus, 157 Minsk, 159 Kazakhstan, 163 Astana, 10393 Almaty, 983 Turkey, 11508 Istanbul, 171 Uzbekistan, 10335 Tashkent, 168 Azerbaijan, 167 Armenia, 10262 Yerevan, 169 Georgia, 84 USA, 102 Germany, 95 United Kingdom. Leave empty to let Yandex choose." }, "maxItemsPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many results to return for each query. Yandex serves about 10-20 per page and this actor pages through automatically.", "default": 20 }, "maxItems": { "title": "Max results in total", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Hard cap across all queries. Every returned result is one charged event, so this is also your budget cap.", "default": 100 }, "includeAds": { "title": "Include ads", "type": "boolean", "description": "Include Yandex Direct ad slots (type \"ad\"). Their URL is Yandex's click tracker; the advertiser's own domain is in displayedDomain.", "default": true }, "includeFeatured": { "title": "Include featured blocks", "type": "boolean", "description": "Include non-organic SERP blocks such as video carousels, image strips, related searches and the AI answer teaser (type \"featured\"). They occupy a rank slot, which matters for rank tracking. Turn off if you only want the ten blue links.", "default": true }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 40, "type": "integer", "description": "Safety stop on how deep to page for one query.", "default": 15 }, "domain": { "title": "Yandex domain", "enum": [ "yandex.com.tr", "yandex.uz", "yandex.com", "yandex.ru", "yandex.kz", "yandex.by", "yandex.com.ge", "yandex.az" ], "type": "string", "description": "Which Yandex front-end to query. All of them serve the same index and honour the same region code, but yandex.com.tr and yandex.uz answer automated requests far more reliably — the default is there for a reason. Change it only if you specifically need another host.", "default": "yandex.com.tr" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is. Apify datacenter proxy with a new session per request is what keeps Yandex answering; residential proxy is not needed and costs far more.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }