# Google Autocomplete Keyword Scraper – Long-tail SEO (`signal_lab/google-autocomplete-keywords`) Actor

Bulk Google Autocomplete keyword scraper for live long-tail suggestions by country and language. A–Z and question expansion, hard limits, no API key.

- **URL**: https://apify.com/signal\_lab/google-autocomplete-keywords.md
- **Developed by:** [Signal Lab](https://apify.com/signal_lab) (community)
- **Categories:** SEO tools, 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 keyword 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 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 Keyword Scraper – Long-tail SEO

Turn seed phrases into current Google autocomplete suggestions by country and language. Expand each seed with A–Z and question prefixes, deduplicate the results, and export a clean keyword dataset.

### Start in under a minute

1. Add up to 100 seed queries.
2. Choose a two-letter language and country code.
3. Set a hard result cap and run the Actor.

```json
{
  "queries": ["electric car"],
  "language": "en",
  "country": "us",
  "expandAlphabet": true,
  "includeQuestions": true,
  "maxResults": 200
}
```

### Example result

```json
{
  "query": "electric car",
  "seed": "electric car c",
  "suggestion": "electric car charging stations near me",
  "rank": 1,
  "language": "en",
  "country": "us",
  "source": "google-autocomplete",
  "scrapedAt": "2026-08-09T10:37:04.000Z"
}
```

### What you get

- One row per unique suggestion.
- The original query and expanded seed that produced it.
- Suggestion rank, language, country, source, and timestamp.
- Automatic deduplication across all expansions.
- A hard `maxResults` cap for predictable output and spend.
- JSON, CSV, Excel, API, schedule, webhook, and integration support through Apify.

### Best for

- Long-tail keyword discovery.
- SEO content briefs and topical maps.
- Product, comparison, and purchase-intent research.
- Country- and language-specific content planning.
- Monitoring how users phrase questions around a brand or problem.

### Pricing and limitations

Current launch pricing starts at **$0.50 per 1,000 keyword results**; check the Pricing tab for all billable events and the exact run estimate.

Autocomplete suggestions are discovery signals, not search-volume estimates. Results can change over time and vary by language, country, and Google behavior. This Actor does not return CPC, competition, or monthly search volume.

# Actor input Schema

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

Up to 100 phrases to expand with current Google search suggestions.

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

Google hl code, for example en, uk, de.

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

Google gl code, for example us, ua, de.

## `expandAlphabet` (type: `boolean`):

Request seed + a, seed + b, and so on.

## `includeQuestions` (type: `boolean`):

Add how, what, why, where, when, which, who, can, and best.

## `alphabet` (type: `string`):

Characters appended to each seed when alphabet expansion is enabled.

## `maxResults` (type: `integer`):

Hard cap on deduplicated paid keyword rows emitted by the run.

## Actor input object example

```json
{
  "queries": [
    "electric car"
  ],
  "language": "en",
  "country": "us",
  "expandAlphabet": true,
  "includeQuestions": true,
  "alphabet": "abcdefghijklmnopqrstuvwxyz",
  "maxResults": 1000
}
```

# Actor output Schema

## `keywords` (type: `string`):

No description

## `summary` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("signal_lab/google-autocomplete-keywords").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 = {}

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

```

## MCP server setup

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

```

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/gK5jt7DjebNhSJEo0/builds/cci3ChffzMVjkMsw1/openapi.json