{
"openapi": "3.0.1",
"info": {
"title": "Yandexsearch Scraper | Search Results and Rankings",
"description": "Yandex Search scraper (Яндекс Поиск): organic Yandex SERP results by keyword or search URL, with rank, title, URL, snippet, domain, displayed URL and country, by city, language and date. 50 results in 8 seconds, 19 fields each. A Парсер выдачи Яндекса for SEO rank tracking in 2026. No account.",
"version": "1.0",
"x-build-id": "raRyCc8KAF0R2kTMK"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~yandexsearch-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-yandexsearch-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/silentflow~yandexsearch-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-yandexsearch-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/silentflow~yandexsearch-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-yandexsearch-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": "🔎 Keywords",
"type": "array",
"description": "What you would type into Yandex, one keyword per line, in any language: купить кофемашину, istanbul otelleri, best crm for small business.
Each keyword returns up to 250 organic results (Yandex shows no more). Yandex's search operators work too: site:apify.com, \"exact phrase\".",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Yandex search URLs",
"type": "array",
"description": "Paste search pages you already have open, from any Yandex site: https://yandex.ru/search/?text=купить+кофемашину&lr=213, yandex.com.tr, yandex.kz, ya.ru. The keyword, city (lr), results language and date filter are read from the URL; the fields below fill in what the URL does not say.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"country": {
"title": "🌍 Country",
"type": "string",
"description": "The Yandex site and region to search from. Pick a country, or type its code (tr, tur) or its English name. Russia, Turkey, Kazakhstan, Belarus, Uzbekistan, Azerbaijan and Georgia use their own Yandex site; other countries use yandex.com with that country's region. A country not in the list gets Yandex's worldwide results.",
"default": "ru"
},
"region": {
"title": "📍 City",
"type": "string",
"description": "Rank results for one city instead of the whole country. Pick a city, type its name in English or Russian (Kazan, Казань), or type any Yandex region code (lr), for example 213 for Moscow. Leave empty to rank for the country."
},
"language": {
"title": "🗣️ Results language",
"enum": [
"any",
"ru",
"en",
"tr",
"uk",
"kk",
"be",
"uz",
"az",
"de",
"fr",
"id",
"tt"
],
"type": "string",
"description": "Keep only pages written in one language. Any language returns what Yandex shows by default. A narrow language on a broad keyword returns fewer results: Belarusian or Tatar can return only a handful.",
"default": "any"
},
"timeRange": {
"title": "📅 Published within",
"enum": [
"any",
"day",
"threeDays",
"week",
"twoWeeks",
"month",
"threeMonths",
"sixMonths",
"year"
],
"type": "string",
"description": "Keep only pages Yandex dated within this period. With a period set, every row also gets its publishedAt date. Recent periods suit news and trend tracking; they return fewer results than Any time.",
"default": "any"
},
"maxResultsPerQuery": {
"title": "🔢 Results per keyword",
"minimum": 1,
"maximum": 250,
"type": "integer",
"description": "Organic results to collect for each keyword or URL, in Yandex's order. Yandex shows at most 250 results per search (25 pages of 10). 10 is the first page, 100 the top 100 for rank tracking.",
"default": 50
},
"maxItems": {
"title": "🧮 Max results in total",
"minimum": 1,
"type": "integer",
"description": "Stop the run once this many rows are saved, across all keywords and URLs. Set it to what you actually need: the run stops there even if keywords remain.",
"default": 1000
},
"debugMode": {
"title": "🐞 Debug mode",
"type": "boolean",
"description": "Write detailed progress to the run log. Leave off for normal runs.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}