# Google Autocomplete Keyword Ideas (`hichemdev/google-autocomplete-keywords`) Actor

Turn seed keywords into hundreds of real Google Autocomplete suggestions with A-Z and question-based expansion. A fast, affordable keyword-research tool for SEO, content ideas, and PPC - discover long-tail keywords real users are searching.

- **URL**: https://apify.com/hichemdev/google-autocomplete-keywords.md
- **Developed by:** [Hichem Ben Moussa](https://apify.com/hichemdev) (community)
- **Categories:** SEO tools, Marketing
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Ideas 🔍

**Turn a few seed keywords into hundreds of real keyword ideas** straight from Google Autocomplete — the same suggestions real users see. Includes A-Z and question-word expansion (an AnswerThePublic-style workflow) for deep long-tail keyword discovery. A fast, affordable alternative to expensive keyword tools.

### ⚙️ What it does

- **`suggest`** — raw Google Autocomplete for each seed.
- **`expand`** — appends every letter `a-z` and question words (`what`, `why`, `how`, `best`, `vs`, `near me`…) to uncover long-tail keywords, then de-duplicates.

### 🎯 Use cases

- **SEO specialists** — discover long-tail keywords and content gaps to target.
- **Content marketers & bloggers** — generate topic and question ideas at scale.
- **PPC managers** — expand ad keyword lists and find negative keywords.
- **Affiliate & niche-site builders** — validate demand around a niche fast.
- **Product & market research** — see what people actually search around a term.

### 📥 Input

- `keywords` — seed terms.
- `mode` — `suggest` or `expand`.
- `language` (`hl`) / `country` (`gl`) — localize results.
- `includeAlphabet` / `includeQuestions` — expansion toggles.
- `maxPerSeed` — cap ideas per seed.

### 📤 Output

```json
{
  "seed": "web scraping",
  "keyword": "web scraping python tutorial",
  "source": "q:how",
  "language": "en",
  "country": "us"
}
```

### 🔌 Integrations & scheduling

- **Schedule** recurring keyword pulls to track how suggestions change over time.
- Export to **CSV, Excel, JSON, or Google Sheets**, or pull via the Apify API.
- Drop the keyword list straight into your SEO or content workflow.

### ❓ FAQ

**Are these real search suggestions?** Yes — they come directly from Google's public autocomplete endpoint, localized by language and country.

**How many keywords will I get?** With `expand` mode, a single seed typically yields dozens to a few hundred unique long-tail ideas.

**Do I need a proxy?** Not for normal use. For very high volume, a proxy (roadmap) helps avoid rate limiting.

**How is it priced?** Pay per result — per keyword idea returned. No subscription.

### 🗺️ Roadmap

- People Also Ask & related-searches expansion
- Optional search-volume estimates
- Proxy support for large batches
- Grouping ideas by search intent

# Actor input Schema

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

One or more seed terms to expand into keyword ideas.

## `mode` (type: `string`):

"suggest" returns raw autocomplete for each seed. "expand" also appends A-Z letters and question words to discover many more keyword ideas.

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

Two-letter language code, e.g. en, es, fr, de.

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

Two-letter country code, e.g. us, gb, in.

## `includeAlphabet` (type: `boolean`):

Append each letter a-z to the seed (expand mode).

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

Add what/why/how/best/vs etc. (expand mode).

## `maxPerSeed` (type: `integer`):

Maximum number of keyword ideas to return per seed term.

## Actor input object example

```json
{
  "keywords": [
    "web scraping"
  ],
  "mode": "expand",
  "language": "en",
  "country": "us",
  "includeAlphabet": true,
  "includeQuestions": true,
  "maxPerSeed": 300
}
```

# 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": [
        "web scraping"
    ]
};

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

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=hichemdev/google-autocomplete-keywords",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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