{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Keywords — with Relevance Scores", "description": "Turn a seed keyword into the phrases people actually type, straight from Google's autocomplete, with Google's own relevance score on every suggestion. Alphabet, question and comparison expansions for depth. Web, YouTube, Images and Shopping. You set the language and country. Keyless.", "version": "0.1", "x-build-id": "3gd5uJBsRiDX21JMi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~google-autocomplete-keywords/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-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/xtracto~google-autocomplete-keywords/runs": { "post": { "operationId": "runs-sync-xtracto-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/xtracto~google-autocomplete-keywords/run-sync": { "post": { "operationId": "run-sync-xtracto-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", "properties": { "keywords": { "title": "Seed keywords", "type": "array", "description": "One or more seeds to expand, such as 'budget tracker' or 'best running shoes'. Each seed is expanded independently and every row says which seed it came from.", "default": [ "budget tracker" ], "items": { "type": "string" } }, "expansion": { "title": "Expansion", "enum": [ "none", "alphabet", "questions", "prepositions", "comparisons" ], "type": "string", "description": "Google returns at most 15 suggestions per query, so depth comes from asking more than once. 'none' asks once per seed. 'alphabet' appends a to z (27 queries per seed) and is the widest net — one seed went from 15 to 57 unique keywords. 'questions' appends how/what/why/when and friends, which is what you want for content and FAQ work. 'prepositions' appends for/with/vs/near, which surfaces intent and use cases. 'comparisons' appends vs/alternative/better than, which surfaces competitors.", "default": "none" }, "dataset": { "title": "Dataset", "enum": [ "web", "youtube", "images", "shopping" ], "type": "string", "description": "Which autocomplete Google should answer from. Only the four listed here demonstrably change the result: measured against the Web baseline for the same query, YouTube differed on 12 of 15 suggestions, Images on 6 of 15, and Shopping on 4 of 7. Google's other datasets are not offered on purpose — News is accepted and then silently ignored (it returns the Web suggestions byte for byte), and Books, Video, Recipes and Products return nothing at all.", "default": "web" }, "language": { "title": "Language (hl)", "type": "string", "description": "Interface language code, such as en, de, id or pt. This is not cosmetic: with no language set, Google answers for wherever the request comes from. The same query from an Indonesian connection returned 'budget tracker adalah' unset, 'budget tracker google sheets' with hl=en, and 'budget tracker excel' with hl=de. Set it to your audience, not to your server.", "default": "en" }, "country": { "title": "Country (gl)", "type": "string", "description": "Two-letter country code, such as us, de, id or br. Works with the language code to place the suggestions in a market. Sent on every request and recorded on every row, so two runs for two markets stay comparable.", "default": "us" }, "maxKeywordsPerSeed": { "title": "Maximum keywords per seed", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop a seed once it has produced this many unique keywords. Useful with the alphabet expansion, where a broad seed can run well past what you need. It caps output, not requests.", "default": 100 } } }, "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 } } } } } } } } } }