{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Scraper: Suggestions, YouTube, Amazon", "description": "Keyword research from autocomplete. Enter seed keywords, get search suggestions from Google, YouTube, Google Shopping, Amazon and Bing, with a to z, number, prefix and question expansion plus a second round. One row per unique suggestion, with its query, position and relevance.", "version": "1.0", "x-build-id": "Jw9VnEud5Jb6DDVFj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fernandosord~google-autocomplete-keywords/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fernandosord-google-autocomplete-keywords", "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/fernandosord~google-autocomplete-keywords/runs": { "post": { "operationId": "runs-sync-fernandosord-google-autocomplete-keywords", "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/fernandosord~google-autocomplete-keywords/run-sync": { "post": { "operationId": "run-sync-fernandosord-google-autocomplete-keywords", "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": "The words to research, one per line. Each seed is sent to every chosen source, plus the expansions you pick below.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Where to ask for suggestions. Google web, YouTube and Google Shopping have separate suggestion lists. Amazon follows the country below (20 marketplaces). Bing follows country and language.", "items": { "type": "string", "enum": [ "google", "youtube", "shopping", "amazon", "bing" ], "enumTitles": [ "Google web search", "YouTube", "Google Shopping", "Amazon", "Bing" ] }, "default": [ "google" ] }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code, for example us, gb, de, fr, mx, jp. It sets Google's gl value, the Amazon marketplace and the Bing market. Amazon is available for us, ca, mx, br, gb, de, fr, it, es, nl, se, pl, tr, ae, sa, eg, jp, au and sg.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Language code for the suggestions, for example en, de, es, pt-BR, ja. It sets Google's hl value and the Bing market. The seed keywords should be written in that language.", "default": "en" }, "expansions": { "title": "Expansion modes", "type": "array", "description": "How to widen each seed. Seed alone sends the keyword as typed. A to z adds one letter after the seed (seed a, seed b). 0 to 9 adds a digit. Letters before sends a letter then the seed (a seed). Question words send how, what, why, can, is, does, where, which, when and who before the seed. Prepositions send vs, versus, for, near, with, without, and, or, to and like after it. Each mode adds queries, so pick what you need.", "items": { "type": "string", "enum": [ "seed", "alphabet", "numbers", "prefixLetters", "questions", "prepositions" ], "enumTitles": [ "Seed alone", "Seed + a to z", "Seed + 0 to 9", "Letters before seed (a to z)", "Question words before seed", "Prepositions after seed (vs, for, near)" ] }, "default": [ "seed" ] }, "depth": { "title": "Depth", "minimum": 1, "maximum": 2, "type": "integer", "description": "1 sends only the queries above. 2 adds a second round: the best first-round suggestions of each seed and source are sent as queries of their own to find more specific long-tail keywords. Rows from the second round have depth 2. Values above 2 are treated as 2.", "default": 1 }, "secondRoundSeeds": { "title": "Second round: suggestions to expand", "minimum": 1, "maximum": 100, "type": "integer", "description": "Only used with depth 2. How many first-round suggestions per seed and source are sent again as queries, highest relevance first (Google sources) or in list order. Each one is one extra request.", "default": 10 }, "maxSuggestions": { "title": "Max suggestions per seed and source", "minimum": 0, "type": "integer", "description": "Stops querying a seed and source once this many unique suggestions are found. Each unique suggestion is one billed result. 0 means no cap.", "default": 200 } } }, "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 } } } } } } } } } }