{ "openapi": "3.0.1", "info": { "title": "Google Search Autocomplete Scraper Youtube Suggestions", "description": "Scrape Google Search autocomplete suggestions in real time. Collect keyword ideas, query variations, trending searches, and long-tail phrases at scale. Ideal for SEO research, content planning, PPC targeting, and market analysis. Export structured results in JSON, CSV, or Excel.", "version": "0.1", "x-build-id": "HX7tS4vwB9ciOdndF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~google-search-autocomplete-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-google-search-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/scraper-engine~google-search-autocomplete-api/runs": { "post": { "operationId": "runs-sync-scraper-engine-google-search-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/scraper-engine~google-search-autocomplete-api/run-sync": { "post": { "operationId": "run-sync-scraper-engine-google-search-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 keywords", "type": "array", "description": "One seed phrase per line. Each seed is expanded into live autocomplete suggestions. Example: [\"minecraft\", \"best laptops 2024\"].", "items": { "type": "string" } }, "sources": { "title": "πŸ“‘ Suggestion sources", "type": "array", "description": "Which autocomplete corpora to query per seed. 'web' = Google web search suggest; 'youtube' = YouTube search suggest (a genuinely different result set). Default: both.", "items": { "type": "string", "enum": [ "web", "youtube" ], "enumTitles": [ "πŸ” Google web search", "πŸ“Ί YouTube search" ] }, "default": [ "web", "youtube" ] }, "deduplicateSuggestions": { "title": "🧹 Deduplicate YouTube against web", "type": "boolean", "description": "When on, the YouTube list drops any term already in the Google web list, so youtubeSuggestions holds only net-new video-search phrases (shared terms still reported in bothSourcesSuggestions). Turn off to keep the raw YouTube list. Default: on.", "default": true }, "suggestionLanguage": { "title": "🌐 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": "Interface language (hl) for the suggestions. Default: English.", "default": "English" }, "targetCountry": { "title": "πŸ“ 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": "Geo (gl) the suggestions are localized for. Default: United States.", "default": "United States" }, "alphabetPrefix": { "title": "⚑ A-Z prefix expansion", "type": "boolean", "description": "Prepend each letter a-z before every seed (a minecraft, b minecraft…) to mine more long-tails. Multiplies request count by 26. Default: off.", "default": false }, "alphabetSuffix": { "title": "⚑ A-Z suffix expansion", "type": "boolean", "description": "Append each letter a-z after every seed (minecraft a, minecraft b…) to mine more long-tails. Multiplies request count by 26. Default: off.", "default": false }, "proxyConfiguration": { "title": "πŸ”’ Proxy", "type": "object", "description": "Optional proxy. The actor already falls back none β†’ datacenter β†’ residential automatically; set this only to force residential from the start." } } }, "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 } } } } } } } } } }