Keyword Research with Google Autocomplete: A to Z

Keyword research with Google autocomplete: real suggestions for up to 500 seed keywords per run, per country and language, with optional a-to-z and question-word expansion for hundreds of long-tail keywords per seed. Ranked, deduplicated, no API key. Pay per keyword. and language, ranked and scored the way Google scores them. Switch on the a-to-z and question-word expansions and one seed becomes hundreds of long-tail keywords. You only pay for suggestions that are actually delivered.

Why this scraper

• The real thing, per market. Autocomplete differs per country and language; set country and language and you get what people in that market see as they type.
• Relevance score and type. Google's Chrome client returns a relevance score and a type (QUERY, ENTITY, NAVIGATION) per suggestion; both are delivered, so you can sort by what Google itself ranks highest.
• Expansion built in. expandAlphabet queries "
• Lightweight route. Under 1 KB per call; no browser, no rendering. In testing on 13-09-2026 a call returned 15 suggestions in 886 bytes.
• Only delivered suggestions are charged. A seed with nothing to suggest comes back as a clear error record at no cost. No start fee.

Who this is for

SEO and content teams building keyword lists and topic clusters. Marketplace sellers looking for how buyers phrase a product. Anyone who wants to see the questions people type after a brand or topic, per country, without clicking through Google letter by letter.

Who this is not for

Autocomplete gives what people type, not how often. There is no search volume in this data; combine it with the Google Trends Batch Scraper from the same publisher for relative interest, or with your own volume source. Suggestions are also personalised away: the route is anonymous, so you see the generic list, not what a logged-in user sees.

Input fields

Field	Type	Required or default	What it does
keywords	list of text	required	One seed keyword per row (up to 500). Each seed is one input; a seed without suggestions comes back as a free error record.
country	text	US	Two-letter country code that sets the market (gl), e.g. US, GB, NL, DE.
language	text	en	Interface language (hl), e.g. en, nl, de. Suggestions follow the language people type in that market.
expandAlphabet	true/false	false	Also query '
expandQuestions	true/false	false	Also query 'how
customPrefixes	list of text	empty	Your own expansions, one per row. Use * for the seed position, e.g. 'beste ' or ' kopen'. Without * the text is used as a suffix.
maxSuggestionsPerKeyword	number	200	Cost ceiling per seed across all expansions. One delivered suggestion is one charged event.

Input example

{
    "keywords": ["air fryer", "electric bike"],
    "country": "US",
    "language": "en",
    "expandAlphabet": false,
    "expandQuestions": true,
    "customPrefixes": [],
    "maxSuggestionsPerKeyword": 200
}

Cost control: a plain seed is one call (up to 15 suggestions); expandAlphabet adds 26 calls, expandQuestions adds 10, each custom pattern adds 1. maxSuggestionsPerKeyword caps what is delivered and charged per seed.

Output example

Field	Type	What it holds	Example
keyword	text	The seed you asked for; every suggestion row traces back to one seed.	electric bike
query	text	The string that was really sent to Google: the seed itself, or the seed widened with a letter or a question word.	electric bike
suggestion	text	The completion Google offers, which is what people actually type there.	electric bike for adults
rank	number	The place of the suggestion in Google's list, counting from 1; the first is what most people pick.	1
relevance	number	Google's own weight for the suggestion; higher means it is offered more firmly.	1200
suggestionType	text	What kind of suggestion it is, for example a plain query or a navigational one.	QUERY
country	text	The country the request was made from; Google answers differently per country.	US
language	text	The interface language the suggestions were read in.	en

{
    "keyword": "air fryer",
    "query": "how air fryer",
    "suggestion": "how air fryer works",
    "rank": 17,
    "relevance": 601,
    "suggestionType": "QUERY",
    "country": "US",
    "language": "en",
    "status": "ok"
}

A seed that yields nothing produces an error record instead, and is not charged:

{
    "input": "qzxwv nonsense 99999",
    "status": "error",
    "errorCode": "NO_SUGGESTIONS",
    "error": "Google has no autocomplete suggestions for 'qzxwv nonsense 99999' in US"
}

Error codes: INVALID_KEYWORD, NO_SUGGESTIONS, BLOCKED. INPUT_TRUNCATED appears once when your input is longer than this actor accepts.

Related actors from steadydata

• google-trends-batch: real interest over time for the same keywords
• google-trending-searches: what is trending right now per country
• Used together with google-ads-transparency and google-trends-batch in a recipe: See what an advertiser runs and what people search for.

Pricing

Pay per event: one suggestion-listed event per delivered suggestion. No start fee, no charge for seeds that fail, no separate platform-usage surcharge.

Free Apify plan: this actor delivers up to 25 rows per run for accounts on the Apify free plan, and then stops with a message. That limit is set by us, not by Apify. It exists so the actor keeps paying for itself for the people who do pay. Any paid Apify plan runs it at full size, billed per delivered row, with failed rows never charged.

Reviews: if this actor saves you time, a short review on this page is the one thing that helps most. Ratings are what other buyers look at first, and we have no other way to ask.

FAQ

What does the relevance score mean? Google's own ranking weight for that suggestion within that query; in testing the values ran from 550 to about 1250, higher is ranked higher. It is comparable within one query, not across different seeds.

Why do I get different suggestions than in my browser? Your browser adds your history, location and account. This route is anonymous and market-level, which is what keyword research wants.

Are the question words available in other languages? The built-in set is English. For any other language, put your own patterns in customPrefixes, with * where the seed goes: "waarom ", " kopen", "* ervaringen".

How many suggestions per seed? Up to 15 per call. In testing on 13-09-2026, a seed with the question-word expansion yielded 140 to 165 unique suggestions, and a seed with both expansions plus four custom patterns 500 to 600. The exact number depends on how much Google has to say about the topic.

Is personal data collected? No. Autocomplete is aggregate data about what many people type; nothing about any individual is involved.

What happens when Google changes something? Routes change from time to time. The actor is monitored daily and fixed fast, and while it is broken you are not charged, because only delivered suggestions cost anything.