# 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
- **Features:** Limited permissions
- **Stats:** 6 total users, 3 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/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 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(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": [
    "web scraping"
  ]
}' |
apify call hichemdev/google-autocomplete-keywords --silent --output-dataset

```

## MCP server setup

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