{ "openapi": "3.0.1", "info": { "title": "Yandex Keyword Suggest Scraper", "description": "Turn one seed term into thousands of the real search queries people type on Yandex, ranked in Yandex's own suggestion order, for the city and market you sell into. Covers Russian, Kazakh and Turkish. Gives you the queries themselves — not an estimate of how often they are searched.", "version": "0.0", "x-build-id": "3HznYK1tRJIdPFqYs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~yandex-keyword-suggest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-yandex-keyword-suggest-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/apt_marble~yandex-keyword-suggest-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-yandex-keyword-suggest-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/apt_marble~yandex-keyword-suggest-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-yandex-keyword-suggest-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", "required": [ "seeds" ], "properties": { "seeds": { "title": "Seed terms", "type": "array", "description": "The topics you want keyword ideas for. One term per line. Each seed is expanded into the real queries people type around it. Up to 50 seeds per run.", "items": { "type": "string" } }, "language": { "title": "Market", "enum": [ "ru", "kk", "tr" ], "type": "string", "description": "Which market's suggestions to collect. This sets the language the suggestions come back in and the ranking they are ordered by.", "default": "ru" }, "regionId": { "title": "Region", "enum": [ "213", "2", "54", "65", "43", "47", "51", "66", "172", "35", "62", "56", "39", "193", "38", "50", "239", "157", "149", "162", "163", "159", "10335", "983" ], "type": "string", "description": "The city or country whose searchers you want. Local brands and local phrasing differ sharply between cities, and this is what makes the list usable for local SEO. Turkey is meant to be used with the Turkish market.", "default": "213" }, "expansionDepth": { "title": "Expansion depth", "minimum": 0, "maximum": 2, "type": "integer", "description": "How far to go beyond the seed itself. 0 returns only what the source suggests for the seed as typed. 1 also combines the seed with buying words, question words, letters and digits — this is the usual choice and returns a few thousand keywords per seed. 2 then re-expands everything found at level 1 and returns the deepest list.", "default": 1 }, "maxKeywordsPerSeed": { "title": "Maximum keywords per seed", "minimum": 1, "maximum": 25000, "type": "integer", "description": "Stop each seed once this many distinct keywords have been collected. This is the main control on how big and how expensive a run is.", "default": 1000 }, "includeVerticalSuggestions": { "title": "Also collect shopping-intent and word-completion suggestions", "type": "boolean", "description": "Adds two further sets of suggestions to each seed: shopping-intent queries, which strip out informational noise and leave the terms people use when they intend to buy, and single-word completions, which surface stems the main list misses. Both are small and both add rows you pay for.", "default": false }, "extraModifiers": { "title": "Extra words to combine with each seed", "type": "array", "description": "Your own words to pair with every seed, in addition to the built-in buying and question words. Useful for brand names, model numbers or an industry's own vocabulary. Up to 40.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Speed", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many parts of the job to work on at once. Higher finishes sooner; lower is gentler on the source. Leave the default unless you have a reason to change it.", "default": 5 } } }, "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 } } } } } } } } } }