# Google Autocomplete Keyword Scraper (`groupoject/google-autocomplete-scraper`) Actor Scrape Google Autocomplete suggestions from seed keywords for SEO, PPC, YouTube, local SEO, and eCommerce keyword research. No API key needed. - **URL**: https://apify.com/groupoject/google-autocomplete-scraper.md - **Developed by:** [Group Oject](https://apify.com/groupoject) (community) - **Categories:** SEO tools, E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Autocomplete Keyword Scraper **Harvest hundreds of real Google Autocomplete suggestions from a handful of seed keywords — no API key required.** Drop in your seeds, pick your expansion strategies, and get back the long-tail keywords people are actually typing into Google: questions, modifiers, comparisons, and "alphabet soup" variations. Perfect for SEO content planning, PPC keyword discovery, and finding the exact phrasing your audience uses. > ⚡ **Works out of the box** — uses Google's public autocomplete endpoint over HTTP. No SerpApi key, no proxy needed for normal volumes. --- ### What it does For each seed keyword, the Actor sends a set of expanded queries to Google Autocomplete and collects every suggestion: | Strategy | Example queries for seed `coffee` | Finds | |---|---|---| | `questions` | `how coffee`, `what coffee`, `why coffee`… | Informational / intent keywords | | `prepositions` | `coffee for`, `coffee with`, `coffee alternative`… | Modifier / commercial keywords | | `alphabet` | `coffee a`, `coffee b` … `coffee z` | Broad "alphabet soup" coverage | | `numbers` | `coffee 0` … `coffee 9` | Model numbers, years, lists | | `comparisons` | `coffee vs`, `coffee or` | Competitor / alternative discovery | Output is **one row per suggestion**, tagged with the seed and the modifier that surfaced it, plus a deduplicated flat keyword list ready to paste into other tools. --- ### Who it's for - **SEO & content teams** — build topic clusters and find long-tail keywords fast. - **PPC marketers** — discover real query phrasings for ad groups and negative keywords. - **YouTubers & creators** — find the questions people ask about your niche. - **eCommerce sellers** — surface product modifiers and comparison searches. - **Anyone doing keyword research** who wants raw Google demand language without a paid SEO suite. --- ### Popular keyword research use cases - **Long-tail SEO keyword research** - expand seed terms into Google Autocomplete suggestions. - **Question keyword discovery** - find "how", "what", "why", and "best" queries for content briefs. - **Local SEO content ideas** - run city/service seeds to uncover real local search phrases. - **eCommerce product modifiers** - discover product attributes, alternatives, comparisons, and buying-intent terms. - **YouTube and creator topics** - turn niche ideas into video titles and search-led content angles. - **PPC ad group and negative keyword research** - collect real phrasing before building campaigns. --- ### Input | Field | Type | Default | Description | |---|---|---|---| | `keywords` | string[] | — | Seed keywords | | `keywordsText` | string | — | Seeds as text (one per line / comma-separated) | | `expansions` | string[] | `["questions","prepositions","alphabet"]` | Which expansions to run | | `geo` | string | `"US"` | Google country code (`gl`) | | `language` | string | `"en"` | Language code (`hl`) | | `maxKeywords` | integer | `100` | Max seeds to process | | `maxSuggestionsPerQuery` | integer | `10` | Cap per query | | `dedupe` | boolean | `true` | Keep only first occurrence of each suggestion | | `fetchMode` | enum | `"http"` | `http` (no key) or `serpapi` (BYO key) | | `serpApiKey` | string (secret) | — | Only for `fetchMode: "serpapi"` | | `requestDelayMs` | integer | `300` | Delay between requests | | `maxConcurrency` | integer | `5` | Parallel requests | | `proxyConfiguration` | object | — | Optional, for high volume | At least one of `keywords` / `keywordsText` is required. #### Example input ```json { "keywords": ["ai seo tools", "content marketing", "email newsletter"], "geo": "US", "language": "en", "expansions": ["questions", "prepositions", "alphabet"] } ```` More in [`examples/`](examples/). *** ### Output One dataset row per suggestion: ```json { "seed": "ai seo tools", "query": "what ai seo tools", "suggestion": "what is ai seo tools", "modifier": "what", "modifierType": "questions", "position": 1, "geo": "US", "language": "en", "source": "google-autocomplete", "fetchedAt": "2026-06-14T02:42:49.918Z" } ``` #### Key-value store outputs - `KEYWORDS` — deduplicated flat list of every suggestion (paste-ready) - `KEYWORDS_BY_TYPE` — suggestions grouped by expansion type - `SUMMARY` — totals, unique count, top seeds by volume - `ERRORS` — any failed queries *** ### How many keywords will I get? Roughly `seeds × queries-per-seed × ~5–10 suggestions`, before dedup. One seed with `questions + prepositions + alphabet` sends ~51 queries and typically yields 100–300 raw suggestions. Scale up by adding seeds. Request math also tells you cost: each query is one HTTP call. 100 seeds × 51 queries = ~5,100 calls — keep `maxConcurrency` modest and `requestDelayMs` ≥ 200 to stay clean, or enable a proxy. *** ### Pricing Pay-per-result — one suggestion row = one billable item. No external API cost in the default `http` mode. *** ### Limitations & honesty - Autocomplete reflects **what Google suggests**, not exact search volume. Pair with a volume tool if you need numbers. - Suggestions are personalized/localized — results vary by `geo` and `language`. - Very high volume from one IP can get rate-limited; raise `requestDelayMs`, lower `maxConcurrency`, or add a proxy. *** ### Related tools - [Google Trends Keyword Monitor](https://apify.com/groupoject/trendpulse-keyword-monitor) — rank keywords by rising/breakout trend. - [Google Trends Content Calendar Generator](https://apify.com/groupoject/trendpulse-content-calendar) — turn trends into a dated publishing plan. *** ### Changelog See [CHANGELOG.md](CHANGELOG.md). # Actor input Schema ## `keywords` (type: `array`): Seed keywords to expand. You can also paste them as text below. ## `keywordsText` (type: `string`): Paste one seed per line or comma-separated. ## `expansions` (type: `array`): Which query expansions to run per seed. More strategies = more keywords but more requests. ## `geo` (type: `string`): Google country code, e.g. US, GB, CA, FR, DE. ## `language` (type: `string`): Language code, e.g. en, fr, es, de. ## `maxKeywords` (type: `integer`): Maximum number of seed keywords to process. ## `maxSuggestionsPerQuery` (type: `integer`): Cap on suggestions kept from each autocomplete query. ## `dedupe` (type: `boolean`): Keep only the first occurrence of each unique suggestion across the whole run. ## `fetchMode` (type: `string`): 'http' uses Google's public suggest endpoint (no key, recommended). 'serpapi' uses your SerpApi key for higher-volume reliability. ## `serpApiKey` (type: `string`): Only needed when fetchMode is 'serpapi'. Get a free key at https://serpapi.com. Never logged. ## `requestDelayMs` (type: `integer`): Delay between requests. Raise if you hit rate limits. ## `maxConcurrency` (type: `integer`): Parallel requests. Lower if you see 429s. ## `proxyConfiguration` (type: `object`): Optional. Use Apify Proxy for high-volume runs to avoid rate limits. ## `debugMode` (type: `boolean`): Verbose logging. ## Actor input object example ```json { "keywords": [ "ai seo tools", "content marketing" ], "expansions": [ "questions", "prepositions", "alphabet" ], "geo": "US", "language": "en", "maxKeywords": 100, "maxSuggestionsPerQuery": 10, "dedupe": true, "fetchMode": "http", "requestDelayMs": 300, "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true }, "debugMode": false } ``` # Actor output Schema ## `suggestions` (type: `string`): One row per suggestion: suggestion, seed, modifier type, query, rank. ## `keywords` (type: `string`): Deduplicated list of every suggestion — ready to paste into other tools. ## `keywordsByType` (type: `string`): Suggestions bucketed by expansion type (questions, prepositions, etc.). ## `summary` (type: `string`): Totals, unique count, and top seeds by volume. ## `errors` (type: `string`): Queries that failed, with error messages. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "ai seo tools", "content marketing" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("groupoject/google-autocomplete-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "ai seo tools", "content marketing", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("groupoject/google-autocomplete-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "ai seo tools", "content marketing" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call groupoject/google-autocomplete-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=groupoject/google-autocomplete-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Autocomplete Keyword Scraper", "description": "Scrape Google Autocomplete suggestions from seed keywords for SEO, PPC, YouTube, local SEO, and eCommerce keyword research. No API key needed.", "version": "1.0", "x-build-id": "O3rQ8THHz58LoMqBN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groupoject~google-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groupoject-google-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/groupoject~google-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-groupoject-google-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/groupoject~google-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-groupoject-google-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", "properties": { "keywords": { "title": "Seed keywords", "uniqueItems": true, "type": "array", "description": "Seed keywords to expand. You can also paste them as text below.", "items": { "type": "string" } }, "keywordsText": { "title": "Seed keywords as text", "type": "string", "description": "Paste one seed per line or comma-separated." }, "expansions": { "title": "Expansion strategies", "type": "array", "description": "Which query expansions to run per seed. More strategies = more keywords but more requests.", "items": { "type": "string", "enum": [ "none", "alphabet", "numbers", "questions", "prepositions", "comparisons" ], "enumTitles": [ "Seed only", "Alphabet (seed a–z)", "Numbers (seed 0–9)", "Questions (how/what/why…)", "Prepositions (for/with/vs…)", "Comparisons (vs/or…)" ] }, "default": [ "questions", "prepositions", "alphabet" ] }, "geo": { "title": "Country (gl)", "type": "string", "description": "Google country code, e.g. US, GB, CA, FR, DE.", "default": "US" }, "language": { "title": "Language (hl)", "type": "string", "description": "Language code, e.g. en, fr, es, de.", "default": "en" }, "maxKeywords": { "title": "Max seeds", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of seed keywords to process.", "default": 100 }, "maxSuggestionsPerQuery": { "title": "Max suggestions per query", "minimum": 1, "maximum": 20, "type": "integer", "description": "Cap on suggestions kept from each autocomplete query.", "default": 10 }, "dedupe": { "title": "Deduplicate suggestions", "type": "boolean", "description": "Keep only the first occurrence of each unique suggestion across the whole run.", "default": true }, "fetchMode": { "title": "Fetch mode", "enum": [ "http", "serpapi" ], "type": "string", "description": "'http' uses Google's public suggest endpoint (no key, recommended). 'serpapi' uses your SerpApi key for higher-volume reliability.", "default": "http" }, "serpApiKey": { "title": "SerpApi API key", "type": "string", "description": "Only needed when fetchMode is 'serpapi'. Get a free key at https://serpapi.com. Never logged." }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between requests. Raise if you hit rate limits.", "default": 300 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests. Lower if you see 429s.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Use Apify Proxy for high-volume runs to avoid rate limits." }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Verbose logging.", "default": false } } }, "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 } } } } } } } } } } ```