{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Scraper: Keyword Suggestions, YouTube", "description": "Get Google Autocomplete keyword suggestions for many seeds, countries and languages: A to Z, 0 to 9, questions, prepositions, recursive depth 0 to 3, Google web, YouTube and Shopping. Up to 15 per query with relevance score, only new suggestions mode. $0.10 per 1,000.", "version": "0.1", "x-build-id": "fyDRcGLIfy83LkriS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ctriolab~google-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ctriolab-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/ctriolab~google-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-ctriolab-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/ctriolab~google-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-ctriolab-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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Seed keywords. Each one is sent to Google Autocomplete as it is and with the expansions you choose below. With no keywords field at all the Actor runs a small demo for \"coffee\".", "items": { "type": "string" } }, "markets": { "title": "Countries and languages", "type": "array", "description": "One country:language pair per line, for example US:en, GB:en, DE:de, BR:pt-BR, KR:ko. A country alone means English. Empty = US:en.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Which autocomplete to read. Google web search, YouTube search or Google Shopping. Each gives its own list.", "items": { "type": "string", "enum": [ "web", "youtube", "shopping" ], "enumTitles": [ "Google web search", "YouTube", "Google Shopping" ] }, "default": [ "web" ] }, "expansions": { "title": "Expansions", "type": "array", "description": "Extra queries per seed. A to Z: \"coffee a\" ... \"coffee z\". 0 to 9: \"coffee 0\" ... \"coffee 9\". Questions: \"how coffee\", \"what coffee\", \"why coffee\" and 9 more. Prepositions: \"coffee for\", \"coffee with\", \"coffee without\", \"coffee vs\", \"coffee near\", \"coffee to\". The seed itself is always queried.", "items": { "type": "string", "enum": [ "alphabet", "numbers", "questions", "prepositions" ], "enumTitles": [ "A to Z", "0 to 9", "Questions (how, what, why ...)", "Prepositions (for, with, vs ...)" ] }, "default": [ "alphabet" ] }, "maxDepth": { "title": "Recursive depth", "minimum": 0, "maximum": 3, "type": "integer", "description": "0 = only the seeds and their expansions. 1 = also query every suggestion found, 2 and 3 go further. Deeper levels grow fast, so keep Max results set.", "default": 0 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many unique suggestions are saved. You pay only for saved suggestions.", "default": 1000 }, "onlyNewSuggestions": { "title": "Only new suggestions", "type": "boolean", "description": "Remember the suggestions saved by earlier runs with the same monitor name and save only ones that are new. Known suggestions are not saved and not charged. Schedule it daily to watch what people start searching for.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate memory for each list you watch. Used only with Only new suggestions.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed in most runs: Google Autocomplete answers without a proxy and the Actor slows down on rate limits. Turn on Apify Proxy for very large runs if you see many retries in the run summary.", "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 } } } } } } } } } }