{ "openapi": "3.0.1", "info": { "title": "Search Suggestions Scraper - Every Engine, One Run", "description": "See what real people are typing into every major search box for any topic you name. Google, Bing, DuckDuckGo and YouTube arrive in one deduped list, so you stop guessing from a single engine's view. Measured: Bing alone contributed 395 keywords Google never suggested.", "version": "1.0", "x-build-id": "DRKpAhffpnWvqfkgI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vonsensey~search-suggestions-keyword-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vonsensey-search-suggestions-keyword-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/vonsensey~search-suggestions-keyword-scraper/runs": { "post": { "operationId": "runs-sync-vonsensey-search-suggestions-keyword-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/vonsensey~search-suggestions-keyword-scraper/run-sync": { "post": { "operationId": "run-sync-vonsensey-search-suggestions-keyword-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 keywords", "type": "array", "description": "The terms to expand. Each seed is fanned out across the selected engines and modifiers. Start broad (\"coffee maker\"), not narrow.", "default": [ "electric bike" ], "items": { "type": "string" } }, "sources": { "title": "Engines", "type": "array", "description": "Which suggestion corpora to mine. Each engine has a genuinely different index — Amazon and eBay surface buying intent, YouTube surfaces content ideas, Google surfaces everything.", "items": { "type": "string", "enum": [ "google", "youtube", "google-images", "google-news", "google-shopping", "bing", "duckduckgo", "amazon", "ebay", "wikipedia", "yandex" ], "enumTitles": [ "Google Web (adds relevance score)", "YouTube", "Google Images", "Google News", "Google Shopping", "Bing", "DuckDuckGo", "Amazon", "eBay", "Wikipedia", "Yandex" ] }, "default": [ "google", "bing", "duckduckgo", "youtube" ] }, "expansions": { "title": "Expansion modes", "type": "array", "description": "How each seed is fanned out. More modes means more long-tail coverage and more lookups. 'Seed only' is a single lookup; 'A-Z' is 26.", "items": { "type": "string", "enum": [ "seed", "questions", "comparisons", "prepositions", "numbers", "alphabet", "alphabet-prefix" ], "enumTitles": [ "Seed only (1 lookup)", "Questions - how / what / why / can ... (15)", "Comparisons - vs / alternative / best / review (11)", "Prepositions - for / with / near / without (12)", "Numbers - seed 0-9 (10)", "A-Z suffix - seed a ... seed z (26)", "A-Z prefix - a seed ... z seed (26)" ] }, "default": [ "seed", "alphabet" ] }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "IE", "NZ", "DE", "AT", "CH", "FR", "ES", "IT", "NL", "BE", "PT", "SE", "NO", "DK", "FI", "PL", "CZ", "GR", "TR", "RU", "UA", "BR", "MX", "AR", "CO", "CL", "IN", "PK", "ID", "MY", "SG", "PH", "TH", "VN", "JP", "KR", "TW", "HK", "CN", "AE", "SA", "EG", "IL", "ZA", "NG", "KE" ], "type": "string", "description": "Two-letter market code. Suggestions are strongly localised — the same seed returns different keywords per country.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code, for example en, de, fr, es, pt-BR.", "default": "en" }, "maxKeywords": { "title": "Max keywords (total)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard ceiling on billable keywords for the whole run. The run stops the moment it is reached. One seed across all engines and expansions can yield 3,000+ keywords, so this is your main cost control.", "default": 300 }, "maxKeywordsPerSeed": { "title": "Max keywords per seed", "minimum": 1, "type": "integer", "description": "Optional. Keeps one broad seed from consuming the whole maxKeywords budget when you pass several. Leave empty for no per-seed limit." }, "maxCostUsd": { "title": "Max cost (USD)", "minimum": 0, "type": "number", "description": "Hard spend ceiling for this run, in USD. Defaults to $5.00 - raise it for large runs. The run stops before crossing it and says so in the diagnostics row.", "default": 5 }, "onlyQuestions": { "title": "Questions only", "type": "boolean", "description": "Keep only question-shaped keywords — the ones that map to FAQ sections and People-Also-Ask style content.", "default": false }, "onlyLongTail": { "title": "Long-tail only", "type": "boolean", "description": "Keep only keywords of three or more words.", "default": false }, "mustContainSeed": { "title": "Must contain the seed", "type": "boolean", "description": "Drop suggestions that drifted away from your seed entirely.", "default": false }, "minWordCount": { "title": "Minimum word count", "minimum": 0, "type": "integer", "description": "Drop keywords shorter than this many words.", "default": 0 }, "excludeTerms": { "title": "Exclude terms", "type": "array", "description": "Drop any keyword containing one of these substrings. Case-insensitive.", "default": [], "items": { "type": "string" } }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Parallel lookups. The default suits every normal run.", "default": 15 }, "proxy": { "title": "Proxy", "type": "object", "description": "Optional. Runs fine without a proxy; a datacenter proxy group helps only on very large runs.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }