{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Suggestions API", "description": "Get current Google Search autocomplete suggestions for bounded keyword batches, optional A-Z expansion, and a selected language and country. Returns one structured, provenance-rich record per lookup with stable arrays for automation and AI agents.", "version": "0.1", "x-build-id": "FzoFtdyQMBeNhJ2hc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~google-autocomplete-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-google-autocomplete-api", "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/khadinakbar~google-autocomplete-api/runs": { "post": { "operationId": "runs-sync-khadinakbar-google-autocomplete-api", "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/khadinakbar~google-autocomplete-api/run-sync": { "post": { "operationId": "run-sync-khadinakbar-google-autocomplete-api", "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": [ "queries" ], "properties": { "queries": { "title": "Seed queries", "minItems": 1, "maxItems": 50, "type": "array", "description": "One to 50 starting phrases sent to Google autocomplete, such as `project management software` or `best running shoes`. The Actor trims and de-duplicates exact repeated phrases, then optionally expands each seed. This is not a list of Google Search result URLs or a list of search-volume keywords.", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "language": { "title": "Suggestion language", "minLength": 2, "maxLength": 16, "type": "string", "description": "Language hint sent to Google as a BCP 47-style code, for example `en`, `es`, or `pt-BR`. Defaults to `en`; Google can still vary predictions with the selected country and live trends. This is not the language of your Apify Console or an output-translation setting.", "default": "en" }, "country": { "title": "Suggestion country", "minLength": 2, "maxLength": 2, "type": "string", "description": "Two-letter ISO country hint sent to Google, for example `US`, `GB`, or `PK`. Defaults to `US` and changes the market context for predictions. This is not a guarantee that every prediction originates from that country.", "default": "US" }, "expansionMode": { "title": "A-Z expansion mode", "enum": [ "none", "suffix", "prefix", "both" ], "type": "string", "description": "Choose `none` for only the seed phrase, `suffix` for `seed a` through `seed z`, `prefix` for `a seed` through `z seed`, or `both` for both directions. Expansion discovers longer phrases but produces more billable autocomplete lookups. The maximum lookup cap always stops expansion predictably.", "default": "none" }, "alphabet": { "title": "Expansion characters", "minLength": 1, "maxLength": 36, "type": "string", "description": "Unique single characters used only when A-Z expansion is enabled, for example `abcdefghijklmnopqrstuvwxyz` or `abc123`. Defaults to the English alphabet and accepts at most 36 unique letters or digits. This is not a query prefix or suffix string.", "default": "abcdefghijklmnopqrstuvwxyz" }, "maxLookups": { "title": "Maximum autocomplete lookups", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard maximum number of query variants fetched in this run. Defaults to 100 and caps at 500, including the original seeds, so expansion cannot create an unbounded bill. Each completed lookup persists one dataset record and costs $0.005 plus platform usage.", "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 } } }, "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 } } } } } } } } } }