{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete & People Also Ask Questions Scraper", "description": "Get Google autocomplete suggestions, People Also Ask questions and related searches for any keyword in 20 countries. Question, comparison and A-Z expansions for content ideas, FAQs and SEO. Fast API results, no browser, no proxies. Pay only per result.", "version": "0.1", "x-build-id": "kravdHufXQySeE7u8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plainrows~google-autocomplete-questions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plainrows-google-autocomplete-questions", "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/plainrows~google-autocomplete-questions/runs": { "post": { "operationId": "runs-sync-plainrows-google-autocomplete-questions", "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/plainrows~google-autocomplete-questions/run-sync": { "post": { "operationId": "run-sync-plainrows-google-autocomplete-questions", "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", "minItems": 1, "maxItems": 1000, "type": "array", "description": "One topic per line, e.g. \"running shoes\" or \"how to learn python\". Up to 500 seeds per run, max 120 characters each.", "items": { "type": "string" } }, "mode": { "title": "What to collect", "enum": [ "both", "autocomplete", "questions" ], "type": "string", "description": "Autocomplete = what Google suggests while typing (with the expansions below). Questions = the \"People also ask\" box and the \"Related searches\" at the bottom of the Google results page for each seed.", "default": "both" }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "IE", "IN", "DE", "AT", "CH", "FR", "BE", "ES", "MX", "IT", "NL", "PT", "BR", "PL", "SE", "JP" ], "type": "string", "description": "Country whose Google suggestions and questions you want.", "default": "US" }, "languageCode": { "title": "Language (optional)", "pattern": "^([a-zA-Z]{2})?$", "type": "string", "description": "Two-letter language code, e.g. \"en\" or \"fr\". Leave empty to use the country's main language (for example German for Switzerland, French for Belgium)." }, "maxResultsPerSeed": { "title": "Max results per seed", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stops looking up more expansions for a seed once it has this many results. Each result is billed; see Pricing.", "default": 300 }, "expandQuestions": { "title": "Question expansions", "type": "boolean", "description": "Also look up the seed with question words in the search language: \"how / what / why / can / is ... running shoes\" (12 words in English, about 10 in other languages). Skipped for a seed that is already a question. Each expansion is one Google lookup.", "default": true }, "expandComparisons": { "title": "Comparison and preposition expansions", "type": "boolean", "description": "Also look up \"running shoes vs / or / for / with / without / near / like / to ...\" (8 to 9 words, localized).", "default": false }, "expandAlphabet": { "title": "A to Z expansions (alphabet soup)", "type": "boolean", "description": "Also look up \"running shoes a\" to \"running shoes z\": 26 more lookups per seed for hundreds of long-tail suggestions.", "default": false }, "customExpansions": { "title": "Custom expansions (optional)", "type": "array", "description": "Your own patterns, up to 50. Use {seed} to place the seed (\"best {seed}\", \"{seed} for kids\"); text without {seed} is added after it.", "items": { "type": "string" } }, "onlyWithSeedWords": { "title": "Only suggestions containing the seed words", "type": "boolean", "description": "Drop autocomplete suggestions that do not contain every word of the seed (Google sometimes fills the list with unrelated queries). Dropped suggestions are not billed. Does not apply to People Also Ask questions.", "default": true }, "paaClickDepth": { "title": "People Also Ask depth", "minimum": 0, "maximum": 4, "type": "integer", "description": "Google reveals more questions each time a question is opened. 0 = only the first 4 questions or so, 4 = up to about 15.", "default": 4 }, "includeRelatedSearches": { "title": "Include related searches", "type": "boolean", "description": "Also return the \"Related searches\" shown at the bottom of the results page.", "default": true } } }, "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 } } } } } } } } } }