# Google Autocomplete Keyword Suggestions - SEO Ideas (`captainhandsome/google-autocomplete-keyword-suggestions`) Actor

Generate localized Google Autocomplete keyword suggestions from multiple seeds. Expand by alphabet or question prefixes and export ranked, deduplicated results.

- **URL**: https://apify.com/captainhandsome/google-autocomplete-keyword-suggestions.md
- **Developed by:** [Joseph McRell](https://apify.com/captainhandsome) (community)
- **Categories:** SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

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 Suggestions API

Turn seed phrases into localized Google Autocomplete suggestions for SEO research, content planning, paid-search discovery, and product-language analysis. Query one or many seeds, optionally expand them by alphabet suffixes or common question prefixes, and export deduplicated results as clean records.

No API key, login, browser automation, or paid proxy is required.

### What data can I extract?

- Original seed and exact request query
- Suggested keyword phrase and its rank in the response
- Expansion suffix or question prefix that produced it
- Language and country localization
- Reproducible source endpoint URL

Each row represents one unique suggestion. Duplicate phrases found through several expansions are emitted once.

### Input example

```json
{
  "queries": ["artificial intelligence", "workflow automation"],
  "language": "en",
  "country": "US",
  "expansion_mode": "questions",
  "max_items": 100
}
```

### Output example

```json
{
  "seed": "artificial intelligence",
  "request_query": "how artificial intelligence",
  "suggestion": "how artificial intelligence is changing the world",
  "rank": 1,
  "expansion": "how",
  "language": "en",
  "country": "US",
  "api_url": "https://suggestqueries.google.com/complete/search?client=firefox&q=how+artificial+intelligence&hl=en&gl=US"
}
```

### Common use cases

- Long-tail SEO and content-brief research
- Discovering customer questions and search language
- Keyword clustering and editorial planning
- Localized keyword ideation across countries and languages
- Building suggestion datasets for agents, spreadsheets, and BI tools

### Use with AI agents and MCP

The flat schema lets an agent expand a topic, group suggestions by intent, compare localized phrasing, or generate a content plan without operating a browser. Set a small `max_items` for interactive tools and an expansion mode for broader research.

### Pricing and cost control

Output is billed per result at **$0.0005 per result** (about $0.50 per 1,000 results), plus a $0.0005 Actor-start charge billed once per gigabyte of memory at run start. Use `max_items` and `expansion_mode` to cap both request volume and charges. The price shown on the Apify Store listing is authoritative.

### Reliability

The Actor calls the public suggestion endpoint directly, retries temporary transport, rate-limit, and service failures, validates the response shape, deduplicates suggestions, and stops at the requested limit. Persistent upstream failures are reported rather than returned as false empty results.

### Limitations and responsible use

- Suggestions are dynamic, localized, and can change between runs.
- Autocomplete is a discovery signal, not verified search-volume data.
- Country and language hints influence results but do not guarantee a particular phrase.
- Large expansion jobs make several requests and should use conservative limits.
- Follow applicable Google terms and use the data responsibly.

### FAQ

#### Does this return search volume?

No. It returns phrases suggested by Google Autocomplete and their response order, not monthly search counts.

#### What does alphabet expansion do?

It requests the seed followed by each letter from a through z, which can expose additional long-tail phrases.

#### Can I search several seeds at once?

Yes. Add them to `queries`; `max_items` applies across the whole run.

#### Are duplicate suggestions billed twice?

No. The Actor deduplicates suggestion text before saving results.

# Actor input Schema

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

One or more seed keywords to expand with Google Autocomplete.

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

Two-letter language code used for suggestions, for example en, es, de, or fr.

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

Two-letter country code used to localize suggestions, for example US, GB, DE, or FR.

## `expansion_mode` (type: `string`):

Optionally fan each seed out by alphabet suffixes, question prefixes, or both.

## `max_items` (type: `integer`):

Hard limit on unique suggestions saved across every seed and expansion.

## Actor input object example

```json
{
  "queries": [
    "artificial intelligence"
  ],
  "language": "en",
  "country": "US",
  "expansion_mode": "none",
  "max_items": 100
}
```

# Actor output Schema

## `results` (type: `string`):

One flat row per unique autocomplete suggestion.

# 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("captainhandsome/google-autocomplete-keyword-suggestions").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("captainhandsome/google-autocomplete-keyword-suggestions").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 captainhandsome/google-autocomplete-keyword-suggestions --silent --output-dataset

```

## MCP server setup

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

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/9le2zbczipeegsnkh/builds/HtAxbqKVUEnFpGIkp/openapi.json