# Google Autocomplete Scraper (`fetch_cat/google-autocomplete-scraper`) Actor

Collect Google autocomplete keyword suggestions by seed query, language, and country.

- **URL**: https://apify.com/fetch_cat/google-autocomplete-scraper.md
- **Developed by:** [Fetch Cat](https://apify.com/fetch_cat) (community)
- **Categories:** SEO tools, Developer tools, Marketing
- **Features:** Limited permissions
- **Stats:** 6 total users, 3 monthly users, 95.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 1,000 keyword suggestions

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Export Google autocomplete suggestions from seed keywords, with each suggestion's order, language, country and source URL. Use this Google Autocomplete Scraper for long-tail keyword research, content planning and PPC ideas—not search-volume estimates or keyword difficulty.

### Quick start

1. Enter one or more seed phrases in **Seed keywords**.
2. Choose a language and country, or keep English and United States.
3. Start the Actor, then open its dataset and export CSV, Excel or JSON.

Start with a small input:

```json
{
  "queries": ["standing desk", "office chair"],
  "language": "en",
  "country": "us",
  "maxSuggestionsPerQuery": 10
}
```

Google may return fewer suggestions than requested. Results vary over time and are not a complete list of searches people make.

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

https://youtu.be/1OW8gOqlZbY?t=25

### Ready-to-run examples

Choose a public example to see its settings before starting a run:

- [Ecommerce product keyword autocomplete scraper](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/ecommerce-product-keyword-autocomplete)
- [Local SEO dentist keyword autocomplete scraper](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/local-seo-dentist-keyword-autocomplete)
- [Google Autocomplete Country Locale Comparison](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/google-autocomplete-country-locale-comparison)

### What you get

One row per saved suggestion, with its seed phrase, returned order, requested locale and client, source URL and fetch time. These are current autocomplete observations rather than search-volume, demand or popularity measurements.

### Who is it for?

- **Keyword researchers** collecting phrase ideas for later investigation.
- **Content teams** preparing topic or question shortlists in their own tools.
- **PPC researchers** reviewing wording variations before separate evaluation.
- **Market researchers** comparing bounded country/language observations.

### How you can use the data

- **Prepare an office-product phrase sheet.** Use the existing standing-desk and office-chair seeds with a small per-seed cap. Keep query, suggestion, rank, sourceUrl and fetchedAt together before grouping ideas in your own planning sheet.
- **Review a local-service wording sample.** Use the existing dentist example or a specific service phrase with the intended country and language. Treat suggestions as wording ideas rather than evidence of demand, expected traffic or conversion.
- **Compare locales through separate runs.** Repeat the same seeds for each chosen country and language, keeping those settings with your exports. Interpret differences as source observations rather than a global popularity ranking.
- **Validate ideas in a separate workflow.** Group returned phrases into topics or questions yourself and review any external metrics separately. This Actor does not calculate volume, CPC, difficulty or relevance scores.

### Input settings

| Setting | JSON key | Purpose |
| --- | --- | --- |
| Seed keywords | `queries` | Required list of phrases. Up to 1,000 unique seeds. |
| Language | `language` | Language code. Default `en`. |
| Country | `country` | Country code. Default `us`. |
| Suggestions per seed | `maxSuggestionsPerQuery` | Save up to 1–20 per seed. Default 10. |
| Autocomplete client | `client` | `firefox` (default), `chrome` or `toolbar`. |
| Request delay | `requestDelayMs` | Pause between seeds. Default 250 ms. |
| Retries per seed | `maxRetries` | Default 2. |
| Use Apify Proxy | `useProxy` | Optional proxy routing. Off by default. |
| Proxy groups | `proxyGroups` | Optional groups used when proxy routing is enabled. |

Blank seeds are ignored and repeated seeds are combined without regard to capitalization. Suggestions retain Google's returned order. This is not a search-volume or popularity ranking. See the input-field help for connection settings and limits.

#### Example inputs

Use the Quick start input as a small first run. Adjust the fields described above for your own data.

### Output data

Each dataset row contains one suggestion. This illustrative shape shows the fields, not a recorded result or a guaranteed suggestion:

```json
{
  "query": "standing desk",
  "suggestion": "standing desk accessories",
  "rank": 1,
  "language": "en",
  "country": "us",
  "client": "firefox",
  "sourceUrl": "https://suggestqueries.google.com/complete/search?client=firefox&q=standing+desk&hl=en&gl=us",
  "fetchedAt": "2026-10-24T12:00:00.000Z"
}
```

| Field | Meaning |
| --- | --- |
| `query` | Trimmed seed phrase associated with the suggestion. |
| `suggestion` | Suggestion text returned by Google. |
| `rank` | One-based position within that seed's saved suggestions. |
| `language`, `country`, `client` | Requested locale and client settings. |
| `sourceUrl` | Source URL for the seed lookup. |
| `fetchedAt` | Fetch time in ISO date-time format. |

#### Download your results

Open your run's dataset, choose **Export** and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See [Apify's download and export guide](https://docs.apify.com/storage/dataset#apify-console) for the available formats and field options.

### Pricing

Pay-per-event pricing uses a one-time `start` charge per run and a `result` event per suggestion saved. A run can incur the start charge even if it saves no suggestions.

Per-suggestion `result` prices increase on every plan from 27 November 2026 (16:00 UTC), with lower rates on higher subscription plans; the `start` fee is unchanged. Current prices apply until then.

Check the [live Pricing tab](https://apify.com/fetch_cat/google-autocomplete-scraper/pricing) for current rates, the scheduled rates and applicable discounts.

### Tips for best results

- **Start with a few specific seeds and a small per-seed cap.** A larger ceiling cannot create suggestions Google does not return.
- **Keep language and country settings with each export.** Use separate runs when comparing locales.
- **Preserve returned order without overinterpreting it.** Rank is the suggestion's saved position for its seed rather than search-volume rank.
- **Use the supported request-delay setting for paced batches.** Source throttling can still affect availability.
- **Check pending queries before repeating a large input.** Not every seed is necessarily processed before a run stops.

### Limits and caveats

The Actor collects autocomplete suggestions only, without search volume, CPC, keyword difficulty, relevance scores or recursive expansion. Suggestions are not a complete list of searches or a popularity ranking.

Blank seeds are ignored and repeated seeds are combined without regard to case. Suggestions retain Google's order, and fewer rows than the per-seed cap can be returned.

Google can throttle requests or return no suggestions for some seeds while others produce useful rows. A seed with no suggestions does not prove a phrase has no demand.

The default run timeout of 20 minutes fits the full 1,000-seed limit; allow about 1 second per seed if you set a shorter timeout. If a run reaches your time limit, it stops cleanly, keeps every saved suggestion, explains the stop in its status message and lists unfinished seeds in PENDING_QUERIES. Inspect the dataset and pending-query record before repeating work. Results vary over time and across requested locales.

No Google login or cookies are required, and this is not an official Google API. Topic grouping, metric validation, historical comparisons and alerts belong in your own workflow.

### Automation and integrations

#### Save your settings for next time

Once you have an input that works for you, [save it as an Apify task](https://docs.apify.com/actors/running/tasks). This keeps your settings together so you can use them again without filling in the form from scratch.

#### Run on a schedule

Need fresh results regularly? You can [schedule the Actor or a saved task](https://docs.apify.com/actors/running/schedules) to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

#### Send results to your other tools

Use **n8n, Make or Zapier** to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the [Apify integration guides](https://docs.apify.com/integrations) for your chosen tool.

For a custom connection, an [Apify webhook](https://docs.apify.com/integrations/webhooks) can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

### API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its `defaultDatasetId` to fetch the results.

For setup instructions, see Apify's [JavaScript client guide](https://docs.apify.com/api/client/js), [Python client guide](https://docs.apify.com/api/client/python) and [Actor runs API reference](https://docs.apify.com/api/v2/acts-runs-post).

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~google-autocomplete-scraper/runs' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @- <<'JSON'
{
  "queries": [
    "standing desk",
    "office chair"
  ],
  "language": "en",
  "country": "us",
  "maxSuggestionsPerQuery": 10
}
JSON
```

#### Node.js

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/google-autocomplete-scraper').call({
  "queries": [
    "standing desk",
    "office chair"
  ],
  "language": "en",
  "country": "us",
  "maxSuggestionsPerQuery": 10
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/google-autocomplete-scraper').call(run_input={'queries': ['standing desk', 'office chair'], 'language': 'en', 'country': 'us', 'maxSuggestionsPerQuery': 10})
print(client.dataset(run['defaultDatasetId']).list_items().items)
```

#### API and AI-agent usage notes

Wait for the run to finish, then read items from the dataset identified by `defaultDatasetId` in the run response. Use the [Apify API documentation](https://docs.apify.com/api/v2) for run status and dataset export.

### MCP and AI agents

You can ask your AI assistant to collect data with **Google Autocomplete Scraper** and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the [Apify MCP server](https://mcp.apify.com/). MCP gives your assistant a way to find this scraper, run it and read the results. Follow the [official setup and sign-in guide](https://docs.apify.com/mcp) for your app.

#### Easier setup with an Apify plugin

If you use a supported coding assistant, the [official Apify plugin](https://docs.apify.com/agents/plugins) can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

#### Use Apify AI in Console

Prefer to keep everything in Apify? Open [Apify AI in Console](https://docs.apify.com/account/apify-ai) and ask it to find Fetch Cat's **Google Autocomplete Scraper**. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

#### Choose your assistant

- **Claude and Claude Code (Anthropic):** [Apify setup guide](https://docs.apify.com/integrations/claude).
- **ChatGPT and Codex (OpenAI):** [Apify setup guides](https://docs.apify.com/integrations/openai).
- **Grok Bot (xAI):** [Apify plugin guide](https://docs.apify.com/integrations/grok-bot).
- **Gemini CLI (Google):** [MCP server setup guide](https://geminicli.com/docs/tools/mcp-server/). Use the server URL below with the HTTP configuration supported by Gemini CLI.

#### Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/google-autocomplete-scraper"
    }
  }
}
```

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

#### Use Apify's general server

Already connected to the general Apify MCP server at `https://mcp.apify.com`? You can use it to find this scraper without adding another server. Ask your assistant to use **Google Autocomplete Scraper** by Fetch Cat, or give it the identifier `fetch_cat/google-autocomplete-scraper`.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

#### Example requests

- “Use Fetch Cat’s Google Autocomplete Scraper to collect up to 5 suggestions each for standing desk and office chair in English for the US. Show seed, suggestion, returned position and source link without estimating search volume.”
- “Collect at most 5 suggestions for dentist in the country and language I provide. Keep locale settings and fetch time beside each phrase for a wording shortlist, without claiming demand or CPC.”
- “Retrieve up to 3 suggestions for my supplied product phrase using the second locale I specify. Keep the returned order and source context so I can compare it with my own earlier locale export, without inventing popularity scores.”

Normal Apify charges apply. Check the [live Pricing tab](https://apify.com/fetch_cat/google-autocomplete-scraper/pricing) before asking your assistant to run a larger batch.

### Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through [x402](https://docs.apify.com/integrations/x402). This experimental option lets an agent use Apify without a conventional account.

[Apify AGI](https://agi.apify.com/) provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

#### Other ways for agents to pay

Apify also supports **MPP** for prepaid access through AGI and **Skyfire** for eligible Actors. If your agent already uses one of these, see the [agentic payment guide](https://docs.apify.com/agents/payments) to choose the right setup.

### FAQ

#### Can I use this as a Google Autocomplete API alternative?

Yes, for exporting suggestions through Apify. It does not provide an official Google API or Google account access.

#### Can I export Google autocomplete to CSV or Excel?

Yes. Export the finished run's dataset as CSV, Excel or JSON, or retrieve it through the Dataset API.

#### Does this include keyword search volume?

No. Suggestions are phrase ideas, not measured demand, traffic or keyword difficulty.

#### Why are some seeds missing from the dataset?

Google may return no suggestions for a seed, especially a specific long phrase. A completed batch with valid empty responses succeeds with an empty dataset. The RUN_SUMMARY key-value record lists each seed as results, empty or failed, with a reason and suggestion count. Request failures, blocked responses and malformed data fail the run while preserving completed results. If the run reaches its time limit, it finishes successfully with the completed suggestions and lists unfinished seeds in PENDING_QUERIES. Do not assume an empty response means no searches exist.

### Related Actors

- [Google Trending Searches Scraper](https://apify.com/fetch_cat/google-trending-searches-scraper) — Explore trending searches separately from autocomplete.
- [Google News Scraper](https://apify.com/fetch_cat/google-news-scraper) — Find news coverage related to your topics.
- [Bing Search Results Scraper](https://apify.com/fetch_cat/bing-search-results-scraper) — Research search-result pages.
- [Website Content Crawler Lite](https://apify.com/fetch_cat/website-content-crawler-lite) — Collect page content for topic analysis.
- [Google Shopping Results Scraper](https://apify.com/fetch_cat/google-shopping-results-scraper) — Explore product-search results.

### Support and feedback

For custom additions or integrations, email <hello@fetchcat.dev>.

Found an error or have a feature request? [Open an issue](https://apify.com/fetch_cat/google-autocomplete-scraper/issues) with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See [Apify’s guide to sharing a run when reporting an issue](https://docs.apify.com/account/collaboration/general-resource-access#automatically-sharing-runs-via-actor-issues). Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. [Leave a review](https://apify.com/fetch_cat/google-autocomplete-scraper/reviews) to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥

# Changelog

This Actor's version history is a separate document: https://apify.com/fetch_cat/google-autocomplete-scraper/changelog.md

# Actor input Schema

## `queries` (type: `array`):

Enter seed words or phrases, up to 1,000 unique seeds. Blank entries are ignored; surrounding spaces and repeated seeds (ignoring capitalization) are removed. At least one non-empty seed is required.

## `language` (type: `string`):

Two-letter Google language code, for example en, es, de, fr, it, pt, or ja.

## `country` (type: `string`):

Two-letter Google country code used to localize suggestions, for example us, gb, de, fr, br, or au.

## `maxSuggestionsPerQuery` (type: `integer`):

Save at most this many suggestions per seed, in Google's returned order. Range 1–20; default 10. Google may return fewer or none. This does not request search-volume estimates or extra keyword expansion.

## `client` (type: `string`):

Google autocomplete response format. Firefox is compact JSON and recommended.

## `requestDelayMs` (type: `integer`):

Polite pause between seed keyword requests. Increase for very large batches.

## `maxRetries` (type: `integer`):

Retry temporary rate-limit or server errors before skipping a keyword.

## `useProxy` (type: `boolean`):

Off by default: requests go directly to Google. Enable to use Apify Proxy for every seed request, with any groups specified below. Proxy use may incur charges according to your Apify account. There is no automatic switch to a proxy after a direct request fails, and this field does not configure customer-supplied proxy URLs.

## `proxyGroups` (type: `array`):

Used only when Use Apify Proxy is enabled. Leave empty for your account's default Apify Proxy pool, or enter groups your account can access. Groups do not enable proxy routing on their own. No specific group is required; access and charges depend on your account.

## Actor input object example

```json
{
  "queries": [
    "apify",
    "web scraping",
    "keyword research"
  ],
  "language": "en",
  "country": "us",
  "maxSuggestionsPerQuery": 10,
  "client": "firefox",
  "requestDelayMs": 250,
  "maxRetries": 2,
  "useProxy": false,
  "proxyGroups": []
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "apify",
        "web scraping",
        "keyword research"
    ],
    "language": "en",
    "country": "us",
    "maxSuggestionsPerQuery": 10,
    "client": "firefox"
};

// Run the Actor and wait for it to finish
const run = await client.actor("fetch_cat/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": [
        "apify",
        "web scraping",
        "keyword research",
    ],
    "language": "en",
    "country": "us",
    "maxSuggestionsPerQuery": 10,
    "client": "firefox",
}

# Run the Actor and wait for it to finish
run = client.actor("fetch_cat/google-autocomplete-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "apify",
    "web scraping",
    "keyword research"
  ],
  "language": "en",
  "country": "us",
  "maxSuggestionsPerQuery": 10,
  "client": "firefox"
}' |
apify call fetch_cat/google-autocomplete-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fetch_cat/google-autocomplete-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/NTBOhzVShlSa0lWou/builds/g1hmRE17ucM1BfSWB/openapi.json