Google Keyword Suggestions Scraper

Extract keyword ideas from Google Autocomplete. Enter seed keywords and get hundreds of real search suggestions that people actually type into Google — perfect for SEO keyword research, content planning, PPC campaign expansion, and niche discovery.

---

What It Does

This actor queries Google's public autocomplete API and returns the suggestions Google shows as you type. For each seed keyword you provide, it can:

1. Fetch the top 10 autocomplete suggestions (base mode)
2. Expand with a–z suffixes to discover 260+ long-tail variations (alphabet mode)
3. Expand with 0–9 suffixes for number-based queries (numbers mode)
4. Combine both for maximum coverage (full mode — up to 370 suggestions per seed)

Suggestions are deduplicated automatically.

---

Input Parameters

Parameter	Type	Default	Description
keywords	string (textarea)	—	One seed keyword per line
language	string	en	Google interface language (en, de, fr, es, etc.)
country	string	us	Country for localized suggestions (us, gb, de, in, etc.)
expand_mode	enum	none	none, alphabet (a-z), numbers (0-9), full (both)
max_suggestions	integer	0	Limit per seed (0 = unlimited)

Example Input

{
  "keywords": "best python framework\nhow to learn javascript\nai tools for",
  "language": "en",
  "country": "us",
  "expand_mode": "alphabet",
  "max_suggestions": 0
}

---

Output Format

Each row in the dataset represents one suggestion:

{
  "seed_keyword": "best python framework",
  "query_variant": "best python framework a",
  "suggestion": "best python framework api",
  "language": "en",
  "country": "us"
}

---

Use Cases

SEO Keyword Research

Enter your target topics as seeds, use alphabet expansion, and get hundreds of long-tail keywords that real users search for. Export to CSV for your SEO workflow.

Content Planning

Discover what questions and topics people search for around your niche. Use the suggestions to plan blog posts, videos, and social media content that matches real search demand.

PPC Campaign Expansion

Find new keyword variations for Google Ads campaigns. Alphabet expansion reveals long-tail terms with lower competition and higher intent.

Competitor Analysis

Enter competitor brand names and product names to see what people search for about them — reviews, alternatives, comparisons, and complaints.

Market Research

Test product ideas by checking what autocomplete suggests. High-specificity suggestions indicate real market demand.

Multilingual Research

Use language and country parameters to discover keyword opportunities in international markets.

---

Rate Limiting & Performance

• Uses Google's public autocomplete endpoint — no API key required
• Polite concurrency (5 parallel requests) to avoid throttling
• Automatic retry with exponential backoff on transient errors
• Base mode: ~1 second per keyword
• Alphabet expansion: ~6 seconds per keyword (27 queries)
• Full expansion: ~8 seconds per keyword (37 queries)

---

Technical Details

• Language: Python 3.12
• HTTP client: httpx (async)
• Apify SDK: apify >= 2.0.0
• API: Google Autocomplete (public, no auth)
• Docker base image: apify/actor-python:3.12