# Google Keyword Suggestions Scraper - Autocomplete A-Z for SEO (`ninhothedev/google-keyword-suggestions-scraper`) Actor

$0.35/1K 🔥 Fast Google Autocomplete scraper! Keyword suggestions with A-Z alphabet expansion for hundreds of long-tail ideas per seed. No key. JSON, CSV, Excel or API in seconds. Pull thousands of keywords for SEO & PPC ⚡

- **URL**: https://apify.com/ninhothedev/google-keyword-suggestions-scraper.md
- **Developed by:** [ninhothedev](https://apify.com/ninhothedev) (community)
- **Categories:**
- **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.

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 Keyword Suggestions Scraper 🔍

Turn any seed keyword into a goldmine of **real Google Autocomplete suggestions** — the exact long-tail phrases people actually type into Google. Perfect for **SEO keyword research, content ideation, PPC campaigns, and market research**.

No API key. No login. Datacenter-proxy friendly. Clean structured JSON out.

> **USP vs. other suggestion scrapers:** built-in **A-Z + 0-9 alphabet expansion**. Flip one switch and every seed is also queried as `{seed} a`, `{seed} b` … `{seed} z`, `{seed} 0` … `{seed} 9`, harvesting **hundreds of extra long-tail keywords** per seed (all deduped).

***

### ✨ Features

- **Google Autocomplete** — the same suggestions Google shows in its search box.
- **Alphabet expansion** — optional A-Z + 0-9 fan-out for massive long-tail coverage.
- **Ranked results** — each suggestion carries its `position` (rank within its query).
- **Localized** — set any `language` (hl) and `country` (gl) for market-specific ideas.
- **Deduplicated** — unique `(seed, suggestion)` pairs only.
- **Clean output** — flat, tabular, ready for Sheets / Excel / your pipeline.
- **Fast & cheap** — lightweight HTTP, no browser, runs on 512 MB.

***

### 🚀 Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `mode` | select | `suggest` | Scraping mode (seed keywords → suggestions). |
| `keywords` | array | `["web scraping","apify"]` | Seed keywords to expand. |
| `language` | string | `en` | Google interface language (hl), e.g. `en`, `de`, `fr`. |
| `country` | string | `us` | Google country (gl), e.g. `us`, `de`, `gb`. |
| `expandAlphabet` | boolean | `false` | Also query `{seed} a`…`z` and `0`…`9` for more long-tail. |
| `maxItems` | integer | `500` | Max unique suggestions (hard cap 5000). |

#### Example input

```json
{
  "mode": "suggest",
  "keywords": ["web scraping", "seo tools"],
  "language": "en",
  "country": "us",
  "expandAlphabet": true,
  "maxItems": 1000
}
```

***

### 📦 Output

Each dataset item is one suggestion:

```json
{
  "seed": "web scraping",
  "suggestion": "web scraping python",
  "position": 2,
  "source": "google-autocomplete",
  "language": "en",
  "country": "us",
  "scraped_at": "2026-07-19T10:30:00+00:00"
}
```

| Field | Description |
|-------|-------------|
| `seed` | The seed keyword this suggestion came from. |
| `suggestion` | The autocomplete keyword phrase. |
| `position` | Rank of the suggestion within its query. |
| `source` | Always `google-autocomplete`. |
| `language` / `country` | The hl / gl used. |
| `scraped_at` | UTC ISO timestamp. |

***

### 💰 Pricing

Roughly **~$1 per 1,000 suggestions** on a typical run (pay-per-usage; actual cost depends on compute). Autocomplete is lightweight, so runs are cheap and fast. Alphabet expansion multiplies output per seed for the same low unit cost.

***

### 🎯 Use cases

- **SEO keyword research** — discover long-tail terms with real search demand.
- **Content ideas** — turn one topic into dozens of article/video angles.
- **PPC / Google Ads** — build keyword lists and negative-keyword candidates.
- **Market research** — see what a market actually asks about a brand or product.

***

### 🆚 Comparison

| | This actor | Typical suggestion scrapers |
|---|---|---|
| Google Autocomplete | ✅ | ✅ |
| A-Z + 0-9 expansion | ✅ built-in | ❌ usually manual |
| Ranked position | ✅ | sometimes |
| Localization (hl+gl) | ✅ | sometimes |
| No API key | ✅ | varies |
| Datacenter-friendly | ✅ | varies |

***

### 🔗 Related actors by ninhothedev

- [SEO On-Page Auditor](https://apify.com/ninhothedev/seo-onpage-auditor)
- [Sitemap URL Extractor](https://apify.com/ninhothedev/sitemap-url-extractor)
- [Datamuse Scraper](https://apify.com/ninhothedev/datamuse-scraper)
- [Google News Scraper](https://apify.com/ninhothedev/google-news-scraper-keywords)

***

Built for marketers and data teams who want more keywords, faster.

# Actor input Schema

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

Scraping mode. Currently 'suggest': turn a list of seed keywords into Google Autocomplete suggestions.

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

Seed keywords to expand. Each seed is sent to Google Autocomplete and returns ranked suggestions.

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

Google interface language code (hl), e.g. 'en', 'de', 'fr', 'es'. Affects which suggestions are returned.

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

Google country code (gl), e.g. 'us', 'de', 'gb', 'fr'. Localizes suggestions to that market.

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

If enabled, also queries '{seed} a', '{seed} b' ... '{seed} z' and '{seed} 0' ... '{seed} 9' to harvest many more long-tail keywords (deduped). Uses 36x more requests per seed.

## `maxItems` (type: `integer`):

Maximum number of unique suggestions to output across all seeds. Hard cap 5000.

## Actor input object example

```json
{
  "mode": "suggest",
  "keywords": [
    "web scraping",
    "apify"
  ],
  "language": "en",
  "country": "us",
  "expandAlphabet": false,
  "maxItems": 500
}
```

# Actor output Schema

## `keywords` (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 = {
    "keywords": [
        "web scraping",
        "apify"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ninhothedev/google-keyword-suggestions-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": [
        "web scraping",
        "apify",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("ninhothedev/google-keyword-suggestions-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": [
    "web scraping",
    "apify"
  ]
}' |
apify call ninhothedev/google-keyword-suggestions-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ninhothedev/google-keyword-suggestions-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/wqFb1hzJNHaBvgUza/builds/SYelb05R8nOOaSr0q/openapi.json