{ "openapi": "3.0.1", "info": { "title": "Yandex (Яндекс) | Парсер Поиска Яндекса", "description": "Яндекс Apify Actor specifically designed for Yandex search scraping. Supports 6+ domains, 19 languages, and provides clean, structured data extraction with intelligent pagination. Парсер поиска Яндекса: органика, реклама, граф знаний, изображения и видео. Для SEO, аналитики и исследований рынка.", "version": "0.0", "x-build-id": "APkvpMxlatTCp5RAP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~Scrape-Yandex/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-Scrape-Yandex", "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/johnvc~Scrape-Yandex/runs": { "post": { "operationId": "runs-sync-johnvc-Scrape-Yandex", "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/johnvc~Scrape-Yandex/run-sync": { "post": { "operationId": "run-sync-johnvc-Scrape-Yandex", "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": [ "text" ], "properties": { "text": { "title": "Search Query", "type": "string", "description": "The search term to search for on Yandex. You can use anything that you would use in a regular Yandex search." }, "include_organic_results": { "title": "Organic results", "type": "boolean", "description": "Return organic (non-paid) search results. Each page of organic results is delivered as its own dataset item (item_type 'organic'). Enabled by default.", "default": true }, "include_ads": { "title": "Ads", "type": "boolean", "description": "Return paid advertisement results when the query triggers them (typically commercial queries). Delivered as items with item_type 'ads'. Off by default.", "default": false }, "include_knowledge_graph": { "title": "Knowledge graph", "type": "boolean", "description": "Return the knowledge graph entity card when present (people, shows, places, brands, etc.). Delivered as items with item_type 'knowledge_graph'. Off by default.", "default": false }, "include_inline_images": { "title": "Inline images", "type": "boolean", "description": "Return the inline image strip that can appear between organic results. Delivered as items with item_type 'inline_images'. Off by default.", "default": false }, "include_inline_videos": { "title": "Inline videos", "type": "boolean", "description": "Return the inline video carousel that can appear between organic results. Delivered as items with item_type 'inline_videos'. Off by default.", "default": false }, "yandex_domain": { "title": "Yandex Domain", "enum": [ "yandex.com", "yandex.ru", "yandex.by", "yandex.kz", "yandex.uz", "yandex.com.tr" ], "type": "string", "description": "The Yandex domain to use for search results. Defaults to 'yandex.com'. Each domain has default language and location settings. Yandex retired its other regional portals (ya.ru search, yandex.az, yandex.com.am, yandex.com.ge, yandex.co.il, yandex.md, yandex.tm, yandex.tj, yandex.eu) - to target those countries, combine a supported domain with the 'lang' and 'lr' parameters.", "default": "yandex.com" }, "lang": { "title": "Language", "enum": [ "null", "ru", "en", "be", "fr", "de", "id", "kk", "tt", "tr", "uk", "uz", "az", "hy", "lv", "lt", "et", "ro", "tk" ], "type": "string", "description": "Language code for search results. Set to null for 'Unspecified'. Can use comma-separated values for multi-language (e.g., 'ru,en'). Defaults to domain language if not specified." }, "lr": { "title": "Location/Region ID (lr)", "minimum": 1, "type": "integer", "description": "Country or region ID to limit search results to a specific geographic location. If not set, the default location for the selected yandex_domain is used (e.g., 84 for yandex.com, 225 for yandex.ru). Common values: 225=Russia, 84=United States, 149=Belarus, 159=Kazakhstan, 171=Uzbekistan, 167=Azerbaijan, 168=Armenia, 169=Georgia, 181=Israel, 208=Moldova, 170=Turkmenistan, 209=Tajikistan, 111=Europe. See the actor README for a full location reference table." }, "max_pages": { "title": "Maximum Pages", "minimum": 0, "type": "integer", "description": "Maximum number of pages to fetch (0 = no limit, default: 2 to avoid too many requests).", "default": 2 }, "groups_on_page": { "title": "Results per Page", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of search result groups (listings) returned per page. Accepts values between 1 and 20. Default is 10.", "default": 10 }, "family_mode": { "title": "Safe Search", "minimum": 0, "maximum": 2, "type": "integer", "description": "Controls safe search filtering. 0 = off (no filtering), 1 = moderate (default), 2 = strict (filter explicit content).", "default": 1 }, "fix_typo": { "title": "Auto-correct Spelling", "type": "boolean", "description": "Automatically correct spelling errors in the search query. Default is true.", "default": true }, "sort_mode": { "title": "Sort Mode", "enum": [ "relevance", "date" ], "type": "string", "description": "How Yandex orders the results. 'relevance' (default) ranks by relevance; 'date' ranks newest first. Applies to all selected result types.", "default": "relevance" }, "period": { "title": "Time Period", "enum": [ "all", "day", "last_two_weeks", "month" ], "type": "string", "description": "Restrict results to a recency window. 'all' (default) = no time limit; 'day' = last 24 hours; 'last_two_weeks' = last 14 days; 'month' = last 30 days. Applies to all selected result types.", "default": "all" }, "output_file": { "title": "Output File", "type": "string", "description": "Optional filename to save results. If not provided, will auto-generate based on search text and parameters." } } }, "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 } } } } } } } } } }