{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Scraper: Google, YouTube, Amazon, Bing", "description": "Turn seed keywords into hundreds of real search suggestions from Google, YouTube, Google Shopping, Amazon and Bing. Alphabet, question and preposition expansion, recursive depth, relevance scores, any language and country. For SEO, PPC, content and product research.", "version": "0.3", "x-build-id": "5A9klFk5JtgZz5eby" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/labrat011~google-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-labrat011-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/labrat011~google-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-labrat011-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/labrat011~google-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-labrat011-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", "minItems": 1, "type": "array", "description": "One per line. Each seed is expanded separately.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Where suggestions come from. Each source is a separate set of rows.", "items": { "type": "string", "enum": [ "google", "youtube", "shopping", "amazon", "bing" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Amazon", "Bing" ] }, "default": [ "google" ] }, "expand": { "title": "Expansion", "type": "array", "description": "Alphabet: seed a ... seed z, seed 0 ... seed 9. Questions: how/what/why/can... seed. Prepositions: seed for/with/vs/near/best... Each adds more queries and many more suggestions. Questions and prepositions use words in your language for en, de, fr, es, it, pt, nl, pl, sv, ja, ko and tr, and are skipped for other languages.", "items": { "type": "string", "enum": [ "alphabet", "questions", "prepositions" ], "enumTitles": [ "Alphabet (a-z, 0-9)", "Questions (how, what, why...)", "Prepositions and modifiers (for, vs, best...)" ] } }, "depth": { "title": "Depth", "minimum": 1, "maximum": 3, "type": "integer", "description": "1: suggestions for the seed and its expansions. 2: also suggestions for every suggestion found. 3: one level deeper. Each level multiplies the number of requests. Depth only goes deeper while the seed is under its max suggestions, so raise that cap too.", "default": 1 }, "maxSuggestionsPerSeed": { "title": "Max suggestions per seed and source", "minimum": 1, "type": "integer", "description": "The run stops collecting for a seed once this many unique suggestions are saved.", "default": 300 }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code: en, de, fr, es, ja...", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code: us, gb, de, fr, in... Amazon supports us, ca, mx, br, gb, de, fr, it, es, nl, jp, in, au.", "default": "us" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed normally. Try it only if a source starts refusing very large runs.", "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 } } } } } } } } } }