# Google Autocomplete API — Bulk Keyword & Questions Scraper (`hipersoft/google-autocomplete-scraper`) Actor

Generate long-tail keyword ideas from Google Autocomplete: alphabet-soup, question and preposition expansions with relevance scores. Fast SEO keyword research, per country and language. Clean, no setup.

- **URL**: https://apify.com/hipersoft/google-autocomplete-scraper.md
- **Developed by:** [Hipersoft](https://apify.com/hipersoft) (community)
- **Categories:** Marketing
- **Features:** Limited permissions
- **Stats:** 7 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.000625 / keyword scraped

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

## Google Autocomplete Scraper — Long-Tail Keywords, Questions & Relevance Scores

Turn a handful of seed keywords into hundreds of **long-tail keyword ideas** from **Google Autocomplete**. This Actor expands each seed with alphabet-soup, question and preposition modifiers, and returns clean, structured **JSON, CSV, Excel or XML** — deduplicated and sorted by Google's relevance score. Fast and reliable, made for SEO specialists, content marketers and PPC teams.

![Google Autocomplete Scraper input — seed keywords, expansion toggles and country/language in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/google-autocomplete-scraper-input.png?v=2)

### What does the Google Autocomplete Scraper do?

The Google Autocomplete Scraper takes your seed keywords and returns the suggestions Google shows as you type, expanded across the alphabet, question words and prepositions. Every suggestion carries a relevance score and the expansion that produced it — ideal for building long-tail keyword lists, content briefs and PPC term sets at scale.

### Features

- 🔤 **Alphabet-soup expansion** — with `alphabetSoup` on, each seed is queried as `<seed> a`…`z` plus `0–9` to surface long-tail variations.
- ❓ **Question expansion** — enable `prependQuestions` to pull `how/what/why/when/where/who/which/are/can/will <seed>` — ideal for FAQ and blog content.
- 🔗 **Preposition & comparison expansion** — enable `appendPrepositions` for `<seed> for/with/without/vs/near/like/to` variants.
- 📊 **Relevance scores** — every keyword carries a `relevance` value, and each seed's results are sorted highest-first.
- 🌍 **Country & language targeting** — set `countryCode` and `languageCode` for localized suggestions.
- 🧹 **Deduplicated & labeled** — each row records the `expansion` that produced it and the `seedKeyword`.

### What you get

![Google Autocomplete Scraper output example — keyword suggestions with relevance scores as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/google-autocomplete-scraper-output.png?v=5)

Each row is one unique keyword suggestion:

```json
{
  "keyword": "coffee grinder",
  "seedKeyword": "coffee",
  "expansion": "alphabet:g",
  "relevance": 1250,
  "countryCode": "us",
  "languageCode": "en"
}
```

#### Output schema

| Field | Type | Description |
| --- | --- | --- |
| `keyword` | string | The autocomplete suggestion returned |
| `seedKeyword` | string | The seed keyword this suggestion was expanded from |
| `expansion` | string | The modifier that produced it, e.g. `alphabet:g`, `question:how`, `preposition:for` |
| `relevance` | integer | Google's relevance score for the suggestion (higher = more prominent) |
| `countryCode` | string | Two-letter country code used for the query |
| `languageCode` | string | Two-letter language code used for the query |

### Input

```json
{
  "keywords": ["coffee", "running shoes"],
  "alphabetSoup": true,
  "prependQuestions": true,
  "appendPrepositions": false,
  "countryCode": "us",
  "languageCode": "en"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `keywords` | array | Seed keywords to expand into autocomplete suggestions (required). |
| `alphabetSoup` | boolean | Also query `<seed> a`…`z` and `0–9`. Default `true`. |
| `prependQuestions` | boolean | Also query question forms like `how <seed>`. Default `false`. |
| `appendPrepositions` | boolean | Also query `<seed> for/with/vs/…`. Default `false`. |
| `countryCode` | string | Two-letter country code. Default `us`. |
| `languageCode` | string | Two-letter language code. Default `en`. |

### Use cases

- Build long-tail keyword lists for SEO and content briefs.
- Mine question keywords to answer real user intent in blog posts and FAQs.
- Find comparison and "near me" terms for local and commercial pages.
- Prioritize keywords by Google's own relevance ordering.
- Localize keyword research by country and language.

### How to scrape Google Autocomplete keywords

1. Add the Google Autocomplete Scraper to your Apify account.
2. Enter your **seed keywords**.
3. Toggle **alphabetSoup**, **prependQuestions** and **appendPrepositions**, and set **countryCode/languageCode**.
4. Click **Run**.
5. **Export** the dataset as JSON, CSV, Excel or XML, or pull it via the Apify API.

### Need more keyword & search data?

- [Google News Scraper](https://apify.com/hipersoft/google-news-scraper) — headlines and articles by topic and region.
- [Amazon Autocomplete Scraper](https://apify.com/hipersoft/amazon-autocomplete-scraper) — product search suggestions for Amazon.
- [Wikipedia Scraper](https://apify.com/hipersoft/wikipedia-scraper) — article content and metadata for topic research.

### FAQ

**How many keywords can I generate per run?**
It depends on your seeds and expansions — with alphabet-soup, questions and prepositions on, a single seed can yield hundreds of suggestions, and you can pass many seeds per run.

**How does billing work?**
You pay only per suggestion you get, so small runs stay cheap. See the **Pricing** tab for current rates.

**What format is the output?**
Structured JSON — one row per suggestion — exportable as JSON, CSV, Excel or XML. Each row includes the keyword, its seed, the expansion, relevance score and locale.

**Can I target a specific country or language?**
Yes. Set `countryCode` and `languageCode` to get suggestions localized to a market.

**Is this only public data?**
Yes. It returns only suggestions Google serves publicly.

**Can I connect this to other tools?**
The Google Autocomplete Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

### Feedback

How did it go? Good or bad, a [review](https://console.apify.com/actors/dWS1ehjJEKgMSmL6z/reviews) helps other users decide and tells us what to improve. Something broken or missing? Open an [issue](https://apify.com/hipersoft/google-autocomplete-scraper/issues) and we'll look at it.

### Related Actors

- [Amazon Autocomplete Scraper](https://apify.com/hipersoft/amazon-autocomplete-scraper)
- [Google News Scraper](https://apify.com/hipersoft/google-news-scraper)
- [Wikipedia Scraper](https://apify.com/hipersoft/wikipedia-scraper)

### Notes

Original clean-room implementation. Returns only suggestions Google serves publicly; you are responsible for compliance with Google's terms. Not affiliated with, endorsed by, or sponsored by Google. Google is a trademark of its respective owner.

# Actor input Schema

## `keywords` (type: `array`):

Seed keywords to expand into autocomplete suggestions.

## `alphabetSoup` (type: `boolean`):

Also query "<seed> a" … "<seed> z" and 0–9 for many more long-tail keywords.

## `prependQuestions` (type: `boolean`):

Also query question forms (how/what/why/when/where/who/which/are/can/will <seed>).

## `appendPrepositions` (type: `boolean`):

Also query "<seed> for/with/without/vs/near/like/to".

## `countryCode` (type: `string`):

Two-letter country code (gl).

## `languageCode` (type: `string`):

Two-letter language code (hl).

## Actor input object example

```json
{
  "keywords": [
    "web scraping",
    "running shoes"
  ],
  "alphabetSoup": true,
  "prependQuestions": false,
  "appendPrepositions": false,
  "countryCode": "us",
  "languageCode": "en"
}
```

# 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 = {
    "keywords": [
        "coffee"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/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 = { "keywords": ["coffee"] }

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/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 '{
  "keywords": [
    "coffee"
  ]
}' |
apify call hipersoft/google-autocomplete-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/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/dWS1ehjJEKgMSmL6z/builds/aYTqX3h6sS7BpMSXd/openapi.json