{ "openapi": "3.0.1", "info": { "title": "Keyword Research Scraper – Google, YouTube, Amazon & App Store", "description": "Keyword research scraper for autocomplete suggestions from Google, YouTube, Bing, Amazon, App Store, DuckDuckGo and eBay in one run. Alphabet, question and preposition expansion turns one seed into hundreds of long-tail keyword ideas. No API key, no proxy, pay only per keyword delivered.", "version": "1.0", "x-build-id": "MamHSlqIBHc4seAM0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nourishing_courier~keyword-research-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nourishing_courier-keyword-research-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/nourishing_courier~keyword-research-scraper/runs": { "post": { "operationId": "runs-sync-nourishing_courier-keyword-research-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/nourishing_courier~keyword-research-scraper/run-sync": { "post": { "operationId": "run-sync-nourishing_courier-keyword-research-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": [ "seedKeywords" ], "properties": { "seedKeywords": { "title": "Seed keywords", "type": "array", "description": "One keyword or phrase per line. Each seed is sent to every selected source and expanded with the modifiers you choose below.", "default": [ "ai tools" ], "items": { "type": "string" } }, "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Which autocomplete engines to query. Each source is isolated: if one is down the others still deliver.", "items": { "type": "string", "enum": [ "google", "youtube", "bing", "amazon", "appstore", "duckduckgo", "ebay" ], "enumTitles": [ "Google", "YouTube", "Bing", "Amazon", "App Store", "DuckDuckGo", "eBay" ] }, "default": [ "google", "youtube", "bing", "amazon", "appstore", "duckduckgo" ] }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code, e.g. en, de, es, sv, fr. Used by Google, YouTube, Bing and DuckDuckGo. Amazon, App Store and eBay follow the country instead.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code, e.g. us, gb, de, fr, se, jp, in, au, ca, br. Picks the Google/Bing/DuckDuckGo region, the Amazon marketplace, the App Store storefront and the eBay site. Unsupported Amazon/App Store/eBay countries fall back to the US with a warning in the log.", "default": "us" }, "expandQuestions": { "title": "Expand with question words", "type": "boolean", "description": "Prepend who, what, why, how, when, where, which, can, does, is, are, should, will to each seed (13 extra queries per seed and source). Finds the questions people actually type - a free People Also Ask alternative.", "default": true }, "expandPrepositions": { "title": "Expand with prepositions", "type": "boolean", "description": "Append for, with, without, near, to, like, vs, versus, and, or to each seed (10 extra queries per seed and source). Surfaces comparison and intent keywords.", "default": false }, "expandAlphabet": { "title": "Expand with a-z (alphabet soup)", "type": "boolean", "description": "Append a space and every letter a to z to each seed (26 extra queries per seed and source). This is the classic alphabet soup method and is where most long-tail keywords come from.", "default": false }, "expandDigits": { "title": "Expand with 0-9", "type": "boolean", "description": "Append 0 to 9 to each seed (10 extra queries per seed and source). Useful for products, years and versions such as 'iphone 17' or 'best laptops 2026'.", "default": false }, "depth": { "title": "Depth", "minimum": 1, "maximum": 2, "type": "integer", "description": "1 = expand only the seeds. 2 = also send every keyword found at level 1 back to the same source as a new query, until 'Maximum keywords per seed' is reached. Depth 2 multiplies results roughly 5-10x.", "default": 1 }, "maxKeywordsPerSeed": { "title": "Maximum keywords per seed", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Cap per seed and source. Caps the level-2 crawl and therefore your cost.", "default": 500 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. None of the sources need a proxy at normal volumes; switch one on only if you run very large depth-2 jobs and see rate limits in the log.", "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 }, "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 } } } } } } } } } }