# 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:** [Hanna Nosova](https://apify.com/fetch_cat) (community)
- **Categories:** SEO tools, Developer tools, Marketing
- **Stats:** 1 total users, 1 monthly users, 46.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.02 / 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.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Scraper

Export Google autocomplete keyword suggestions by seed query, language, country, and client type.

Use this actor when you need a repeatable CSV, JSON, Excel, or API export of long-tail keyword ideas for SEO research, content planning, PPC research, market analysis, or AI-agent workflows.

### At a glance

- **Input:** Seed queries, language, country, suggestion limit, Google client, retry settings, and optional proxy.
- **Output:** Original query, suggestion, rank, language, country, client, source URL, and fetch timestamp.
- **Localization:** Collect suggestions by country and language.
- **Best for:** Keyword research, content ideation, autocomplete exports, and Google Suggest API alternative workflows.
- **Low-cost runs:** Suggestions are lightweight; start with direct requests before enabling proxy.

### Ready-to-run examples

Use these saved Store examples as starting points. Open any example to prefill the Actor input, then adjust URLs, keywords, limits, or filters for your own 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)**
- **[SaaS keyword ideas from Google autocomplete](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/saas-keyword-ideas-google-autocomplete)**
- **[Google Autocomplete AI Tool Problem Phrases](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/google-autocomplete-ai-tool-problem-phrases)**
- **[Google Autocomplete Marketplace Search Queries](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/google-autocomplete-marketplace-search-queries)**
- **[Google Autocomplete App Store Aso Ideas](https://apify.com/fetch_cat/google-autocomplete-scraper/examples/google-autocomplete-app-store-aso-ideas)**
- **[View all ready-to-run examples](https://apify.com/fetch_cat/google-autocomplete-scraper/examples)** (33 examples)

### What can it do?

- **Export Google autocomplete suggestions:** Save ranked suggestion rows for each seed query.
- **Find long-tail keywords:** Collect phrase variants that users may type into Google.
- **Localize keyword research:** Use country and language settings for market-specific suggestions.
- **Support SEO workflows:** Feed suggestions into content plans, keyword maps, and search-intent analysis.
- **Use as a Google Autocomplete API alternative:** Run from the Apify UI, API, schedules, webhooks, or the official Apify MCP server.

### Common workflows

- **SEO keyword research:** Build long-tail keyword lists from seed topics.
- **Content planning:** Turn autocomplete suggestions into article ideas, FAQs, and page titles.
- **PPC research:** Discover wording variations for ad groups and landing pages.
- **Market comparison:** Run the same seed terms across countries and languages.
- **AI-agent briefs:** Fetch live suggestion rows before asking an agent to cluster or prioritize keywords.

### Input example

```json
{
  "queries": ["best running shoes", "how to start a podcast"],
  "language": "en",
  "country": "us",
  "maxSuggestionsPerQuery": 10,
  "client": "chrome",
  "requestDelayMs": 250,
  "maxRetries": 3,
  "useProxy": false,
  "proxyGroups": []
}
```

### Output example

```json
{
  "query": "best running shoes",
  "suggestion": "best running shoes for flat feet",
  "rank": 1,
  "language": "en",
  "country": "us",
  "client": "chrome",
  "sourceUrl": "https://suggestqueries.google.com/complete/search?...",
  "fetchedAt": "2026-07-03T10:00:00.000Z"
}
```

### Input configuration

| Setting | JSON key | What to enter |
| --- | --- | --- |
| Queries | `queries` | Seed keywords or phrases, one per row. |
| Language | `language` | Google language code such as `en`, `de`, `fr`, or `es`. |
| Country | `country` | Country code such as `us`, `gb`, `de`, or `fr`. |
| Maximum suggestions per query | `maxSuggestionsPerQuery` | Number of suggestions to save for each seed query. |
| Client | `client` | Google autocomplete client type, such as `chrome`. |
| Request delay | `requestDelayMs` | Delay between requests. |
| Maximum retries | `maxRetries` | Retry count for failed autocomplete requests. |
| Use proxy | `useProxy` | Enables Apify Proxy for requests. |
| Proxy groups | `proxyGroups` | Optional Apify Proxy groups if your account has access. |

### Output fields

| Field | Description |
| --- | --- |
| `query` | Original seed query. |
| `suggestion` | Google autocomplete suggestion text. |
| `rank` | Suggestion order for the seed query. |
| `language`, `country`, `client` | Requested localization and client settings. |
| `sourceUrl` | Google suggest endpoint URL used for the request. |
| `fetchedAt` | ISO timestamp when the suggestion was fetched. |

### Pricing

This Actor uses Apify pay-per-event pricing. The prices below come from the current Actor pricing configuration. Apify public plans map to Store discount tiers, so the table shows both the user-facing plan context and the pricing tier name. The final price shown in Apify depends on the user account plan and any custom agreement.

| Event | What is charged | Price |
| --- | --- | ---: |
| `start` | One-time fee per run | $0.005 |
| `result` | Per Google autocomplete suggestion saved to the dataset | $0.000024 |

Apify may also charge platform usage for compute, storage, proxies, or data transfer outside this Actor pricing. Check the Actor run and the Apify Pricing tab for the exact cost shown to your account.

### Tips for best results

- Use natural seed phrases instead of single generic words.
- Run separate jobs for different countries and languages.
- Keep `maxSuggestionsPerQuery` close to the number you actually need.
- Increase `requestDelayMs` or enable proxy if Google throttles requests.
- Cluster duplicate suggestions downstream when running many related seeds.

### Limits and caveats

- Suggestions vary by country, language, time, Google experiments, and client type.
- This actor exports autocomplete suggestions only. It does not provide search volume or keyword difficulty.
- Google can return fewer suggestions than requested.
- Proxy groups must exist on your Apify account before you use them.

### API usage

```bash
curl "https://api.apify.com/v2/acts/fetch_cat~google-autocomplete-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": ["best running shoes"],
    "language": "en",
    "country": "us",
    "maxSuggestionsPerQuery": 10
  }'
```

### MCP and AI agents

You can run this actor through the official Apify MCP server at `https://mcp.apify.com`.

For a focused single-actor tool, use:

```text
https://mcp.apify.com?tools=fetch_cat/google-autocomplete-scraper
```

Agent-friendly inputs are `queries`, `language`, `country`, `maxSuggestionsPerQuery`, `client`, `requestDelayMs`, `maxRetries`, `useProxy`, and `proxyGroups`.

### FAQ

**Can this export Google autocomplete to CSV or Excel?**\
Yes. Download the Apify dataset as CSV, Excel, JSON, XML, RSS, or through the Dataset API.

**Does it include keyword volume?**\
No. It exports suggestions, not search volume, CPC, or keyword difficulty.

**Can I use this for content briefs?**\
Yes. Export suggestions and cluster them by intent, topic, or modifier.

**Is this an official Google API?**\
No. It exports public autocomplete suggestions through Apify.

### Related actors

- [Google Trending Searches Scraper](https://apify.com/fetch_cat/google-trending-searches-scraper)
- [Google News Scraper](https://apify.com/fetch_cat/google-news-scraper)
- [Bing Search Results Scraper](https://apify.com/fetch_cat/bing-search-results-scraper)
- [Website Content Crawler Lite](https://apify.com/fetch_cat/website-content-crawler-lite)
- [Google Shopping Results Scraper](https://apify.com/fetch_cat/google-shopping-results-scraper)

### Support

If a run fails, returns no data, or a field looks wrong, open an issue from the Actor page.

Please include the Apify run ID or run URL, input JSON, one example public URL, query, or input item, what you expected, and what the dataset returned. Small reproducible inputs make parsing or site-layout issues much faster to fix.

### Changelog

#### 0.2

- Clarified input settings, output fields, pricing, API usage, and autocomplete-data limits.

#### 0.1

- Initial public release.

### Privacy and data handling

This Actor runs with Apify limited permissions and only processes data needed for the documented run. It uses search/query inputs and public search, trend, app, patent, news, or profile results to produce the output dataset and sends requests to public Google Autocomplete pages/endpoints; results are stored in Apify run storage for your account. FetchCat does not use your inputs or outputs for advertising, does not use them for model training, and does not retain them outside the Apify run except for transient support debugging when you explicitly share run details. You are responsible for using the Actor lawfully, respecting the target site's terms, and avoiding unnecessary personal or sensitive data in inputs.

# Actor input Schema

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

Enter the words or phrases you want to expand into Google autocomplete suggestions.

## `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`):

Upper limit of suggestions saved for each seed keyword. Google usually returns up to 10 suggestions.

## `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`):

Enable only if you run very large batches or need proxy routing. Most small runs work without a proxy.

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

Optional Apify Proxy groups, for example RESIDENTIAL. Leave empty to use automatic proxy settings.

## 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("💾 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 '{
  "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": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=fetch_cat/google-autocomplete-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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