{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Scraper - Alphabet Soup Keywords", "description": "Google Autocomplete and Google Suggest keywords in bulk: alphabet soup expansion (a-z, 0-9, questions, prepositions) of your seed keywords for any country and language. One row per suggestion with seed, modifier and position. No login, no API key.", "version": "1.0", "x-build-id": "5bRnT4Rd3Qu6iV2ff" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~google-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-google-autocomplete-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/kamerozkan~google-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-google-autocomplete-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/kamerozkan~google-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-google-autocomplete-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": [ "keywords" ], "properties": { "keywords": { "title": "Seed keywords", "type": "array", "description": "Seed keywords to expand, for example 'coffee maker' or 'crm software'. Each keyword is sent to Google Autocomplete on its own and with every modifier you enable below (up to 100 keywords).", "default": [ "coffee maker" ], "items": { "type": "string" } }, "countryCodes": { "title": "Countries", "type": "array", "description": "Two-letter country codes such as us, gb, de, fr, es, br or in. Suggestions differ by country, so each country is a separate market and the requests leave from that country. Duplicates are removed per country.", "default": [ "us" ], "items": { "type": "string" } }, "languageCode": { "title": "Language", "type": "string", "description": "Interface language for Google, for example en, de or es. Leave empty to use the main language of each country (us: en, de: de, br: pt)." }, "expandAlphabet": { "title": "Alphabet soup (a-z)", "type": "boolean", "description": "Add every letter after the keyword ('coffee maker a', 'coffee maker b', ...). For de, fr, es, tr and other languages the local letters (for example ä, ö, ü) are added too.", "default": true }, "expandQuestions": { "title": "Question keywords", "type": "boolean", "description": "Put question words before the keyword ('how coffee maker', 'why coffee maker', 'can coffee maker', ...). Great for FAQ and blog topics.", "default": true }, "expandNumbers": { "title": "Numbers (0-9)", "type": "boolean", "description": "Add every digit after the keyword ('coffee maker 1', ...). Finds model numbers, years and sizes.", "default": false }, "expandPrepositions": { "title": "Prepositions and comparisons", "type": "boolean", "description": "Add for, with, without, vs, near, to, like, and, or, in after the keyword ('coffee maker vs', 'coffee maker for').", "default": false }, "customModifiers": { "title": "Custom modifiers", "type": "array", "description": "Your own words to add after the keyword, such as 'best', 'price' or 'review'. Use {keyword} to place the keyword yourself, for example 'best {keyword} for'.", "items": { "type": "string" } }, "includeSeedKeyword": { "title": "Include the seed keyword itself", "type": "boolean", "description": "Also return a row when Google suggests exactly your seed keyword. Off by default, so you only pay for new keywords.", "default": false }, "maxItems": { "title": "Max suggestions", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many unique suggestions in total. You are charged per suggestion, so this also caps the cost of the run. One keyword with alphabet soup and questions gives about 300 to 450 suggestions.", "default": 1000 } } }, "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 } } } } } } } } } }