{ "openapi": "3.0.1", "info": { "title": "Google Search Autocomplete Scraper With Negative Suggestions", "description": "Gather Google autocomplete keyword data quickly and accurately. Capture search variations, trends, and user intent signals across multiple keywords. Perfect for SEO teams, marketers, and analysts building keyword lists or tracking demand shifts.", "version": "0.1", "x-build-id": "2lhGf25wLEYk7x5eP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~google-search-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~google-search-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-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/scrapier~google-search-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-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": "🏢 Brands or Keywords to Monitor", "type": "array", "description": "Brand names, products, or people to watch — one per line. Each is probed against your risk terms. Example: PayPal, Temu, Robinhood.", "items": { "type": "string" } }, "reputationMode": { "title": "🛡️ Reputation Mode", "type": "boolean", "description": "ON: query each brand as-is PLUS one negative-probe per risk term (e.g. 'temu scam', 'temu lawsuit') to surface damaging autocompletes — no a-z volume blow-up. OFF: behave like a plain autocomplete scraper (uses the A-Z expansion toggles below). Default true.", "default": true }, "negativeTerms": { "title": "🚫 Risk / Negative Terms", "type": "array", "description": "Words that mark a completion as damaging. Used both to probe (brand + term) and to flag returned suggestions. Leave empty to use the built-in list (scam, complaints, fraud, lawsuit, ripoff, problems, fake, scandal, sucks, dangerous, recall, refund, not working, down, reviews, vs).", "items": { "type": "string" } }, "includeRelevance": { "title": "📊 Include Relevance & Type", "type": "boolean", "description": "Add Google's own prominence score (relevance_NN) and QUERY vs NAVIGATION classification (type_NN) for every suggestion, plus the seed's verbatimRelevance. Default true.", "default": true }, "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 of the autocomplete suggestions (maps to Google's hl parameter). Default English.", "default": "English" }, "country": { "title": "📍 Target Market (Country)", "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 Google localizes suggestions for (maps to gl). Reputation issues often differ by market. Default United States.", "default": "United States" }, "usePrefix": { "title": "⚡ A-Z Prefix Expansion", "type": "boolean", "description": "Only used when Reputation Mode is OFF. Adds a-z before each keyword (e.g. 'a temu', 'b temu') for broader long-tail discovery. Default false.", "default": false }, "useSuffix": { "title": "⚡ A-Z Suffix Expansion", "type": "boolean", "description": "Only used when Reputation Mode is OFF. Adds a-z after each keyword (e.g. 'temu a', 'temu b'). Default false.", "default": false }, "proxyConfiguration": { "title": "🔒 Proxy Configuration", "type": "object", "description": "Optional proxies. Falls back none → Google SERP datacenter → residential automatically on blocks." } } }, "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 } } } } } } } } } }