{ "openapi": "3.0.1", "info": { "title": "Keyword Suggestions — Google, YouTube & Amazon Autocomplete", "description": "Keyword ideas from Google, YouTube, Google Shopping, Amazon, Bing and DuckDuckGo autocomplete: expand a seed with a-z, 0-9 or question words, get one deduplicated row per keyword with its sources and position, and what is new since your last run. 18 Amazon marketplaces, any language. No login.", "version": "0.1", "x-build-id": "NrToqpytRm5BQPkaw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~keyword-suggestions-autocomplete/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-keyword-suggestions-autocomplete", "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/northbell~keyword-suggestions-autocomplete/runs": { "post": { "operationId": "runs-sync-northbell-keyword-suggestions-autocomplete", "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/northbell~keyword-suggestions-autocomplete/run-sync": { "post": { "operationId": "run-sync-northbell-keyword-suggestions-autocomplete", "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": [ "keywords" ], "properties": { "keywords": { "title": "Seed keywords", "type": "array", "description": "One seed keyword or phrase per line, as you would type it into the search box. Each seed gets its own list of suggestions. Put all your seeds in one run: the run-start fee is charged once.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Which autocomplete services to ask. Every keyword row lists the sources that suggested it, so phrases several services agree on are easy to spot. Amazon follows the country (18 marketplaces, not India).", "items": { "type": "string", "enum": [ "google", "youtube", "google-shopping", "amazon", "bing", "duckduckgo" ], "enumTitles": [ "Google", "YouTube", "Google Shopping", "Amazon", "Bing", "DuckDuckGo" ] }, "default": [ "google", "youtube", "amazon" ] }, "expand": { "title": "Expand each seed", "enum": [ "none", "alphabet", "questions" ], "type": "string", "description": "Autocomplete only shows about 10 phrases per query, so the seed is asked again with a letter or digit added (alphabet) or with question words around it (questions). The question words are English; for other languages use alphabet.", "default": "alphabet" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code, e.g. us, gb, de, fr, jp, in, br. It sets the market for Google, YouTube, Bing, DuckDuckGo and the Amazon marketplace (Amazon supports us, gb, de, fr, it, es, ca, jp, au, mx, br, nl, se, pl, tr, ae, sa, sg).", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Language code of the suggestions and of your seeds, e.g. en, de, ja, es, pt-BR, zh-CN. Use it together with the matching country.", "default": "en" }, "maxKeywordsPerSeed": { "title": "Max keywords per seed", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper limit of unique keywords returned for each seed (and charged). If there are more, the ones suggested by the most sources and ranked highest are kept.", "default": 500 } } }, "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 } } } } } } } } } }