{ "openapi": "3.0.1", "info": { "title": "Google Search Autocomplete Scraper With Negative Suggestions", "description": "Google Search Autocomplete Scraper: Extract autocomplete suggestions for keywords and identify negative or unfavorable search suggestions. Analyze search intent, reputation signals, related queries, and audience concerns for SEO, keyword research, content strategy, and brand monitoring.", "version": "0.1", "x-build-id": "R9qea26udTvJJjEWh" }, "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 } } } } } } } } } }