{ "openapi": "3.0.1", "info": { "title": "Google Search Autocomplete Scraper by Buyer Intent Filter", "description": "Automate the collection of Google autocomplete results for large keyword sets. Build rich keyword datasets with related terms, variations, and search trends. Supports SEO planning, market discovery, and competitive analysis workflows.", "version": "0.1", "x-build-id": "bFELZnhEo32sCHZc4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~google-search-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-google-search-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/api-empire~google-search-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-google-search-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/api-empire~google-search-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-google-search-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": [ "queries" ], "properties": { "queries": { "title": "🌱 Seed keywords", "type": "array", "description": "Seed terms to mine β€” one per line. Each seed returns Google's live autocomplete completions, then every completion is tagged by intent. Example: bluetooth speaker, running shoes, crm software.", "items": { "type": "string" } }, "buyerIntentOnly": { "title": "πŸ›’ Keep buyer-intent only", "type": "boolean", "description": "When ON, drops informational/navigational completions and keeps only transactional + commercial (money) keywords like 'buy', 'price', 'best', 'review', 'near me'. When OFF (default), every completion is returned and tagged. Example: OFF returns all 10 completions with intent labels; ON might return only the 3 buyer-intent ones.", "default": false }, "tagIntent": { "title": "🏷️ Add intent tags & counts", "type": "boolean", "description": "Adds per-completion intent labels (intentTypes, matchedIntentWords) plus per-seed counts (transactionalCount, commercialCount, buyerIntentCount, hasBuyerIntent). Turn OFF for a plain keyword list. Default is ON.", "default": true }, "customIntentWords": { "title": "πŸ’° Extra money words", "type": "array", "description": "Additional transactional trigger words treated as buyer intent on top of the built-in list (buy, price, cheap, coupon, near me…). Example: ['financing', 'lease', 'installment']. Leave empty to use the defaults only.", "items": { "type": "string" } }, "language": { "title": "🌐 Suggestion language", "enum": [ "English", "Spanish", "French", "German", "Italian", "Portuguese", "Russian", "Japanese", "Korean", "Chinese", "Arabic", "Hindi", "Bengali", "Turkish", "Vietnamese", "Polish", "Dutch", "Swedish", "Danish", "Norwegian", "Finnish", "Czech", "Hungarian", "Romanian", "Greek", "Hebrew", "Thai", "Indonesian", "Malay", "Filipino", "Ukrainian", "Bulgarian", "Croatian", "Slovenian", "Slovak", "Lithuanian", "Latvian", "Estonian", "Icelandic", "Irish", "Welsh", "Basque", "Catalan", "Galician", "Afrikaans", "Swahili", "Zulu", "Xhosa", "Amharic", "Somali", "Yoruba", "Hausa", "Igbo", "Persian", "Urdu", "Tamil", "Telugu", "Kannada", "Malayalam", "Marathi", "Gujarati", "Punjabi", "Nepali", "Sinhala", "Burmese", "Khmer", "Lao", "Mongolian", "Tibetan", "Georgian", "Armenian", "Azerbaijani", "Kazakh", "Uzbek", "Turkmen", "Kyrgyz", "Tajik" ], "type": "string", "description": "Language (hl) Google returns completions in. Default is English.", "default": "English" }, "country": { "title": "πŸ“ Target market", "enum": [ "United States", "United Kingdom", "Canada", "Australia", "Germany", "France", "Spain", "Italy", "Brazil", "Mexico", "Argentina", "Chile", "Colombia", "Peru", "Russia", "Ukraine", "Poland", "Netherlands", "Belgium", "Switzerland", "Austria", "Sweden", "Norway", "Denmark", "Finland", "Portugal", "Ireland", "Czech Republic", "Hungary", "Slovakia", "Slovenia", "Croatia", "Greece", "Bulgaria", "Romania", "Turkey", "China", "Japan", "South Korea", "India", "Pakistan", "Bangladesh", "Indonesia", "Malaysia", "Thailand", "Philippines", "Vietnam", "Singapore", "New Zealand", "South Africa", "Egypt", "Nigeria", "Kenya", "Morocco", "Tunisia", "Algeria", "Saudi Arabia", "United Arab Emirates", "Israel", "Jordan", "Lebanon", "Iran", "Iraq", "Kuwait", "Qatar", "Oman", "Bahrain", "Yemen", "Syria" ], "type": "string", "description": "Country (gl) for location-specific completions β€” different markets surface different buyer terms. Default is United States.", "default": "United States" }, "usePrefix": { "title": "πŸ”€ A–Z prefix expansion", "type": "boolean", "description": "Prepend a–z before each seed (a bluetooth speaker, b bluetooth speaker…) to widen the long-tail net. Multiplies request count 26Γ—. Default is off.", "default": false }, "useSuffix": { "title": "πŸ”‘ A–Z suffix expansion", "type": "boolean", "description": "Append a–z after each seed (bluetooth speaker a, bluetooth speaker b…) for more long-tail completions. Multiplies request count 26Γ—. Default is off.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Optional proxy for higher volume. The actor auto-escalates none β†’ datacenter β†’ residential on blocks, so this is only needed for large runs." } } }, "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 } } } } } } } } } }