Google's autocomplete 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, with Google's relevance score and suggestion type. Pay only for delivered suggestions.
One autocomplete suggestion delivered. Seeds that return nothing are never charged; no start fee.
ACTOR=steadydata~google-autocomplete URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items" curl -X POST "$URL?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"keywords": ["air fryer", "electric bike"], "country": "US", "language": "en"}'
import os, requests ACTOR = "steadydata~google-autocomplete" URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items" rows = requests.post( URL, params={"token": os.environ["APIFY_TOKEN"]}, json={'keywords': ['air fryer', 'electric bike'], 'country': 'US', 'language': 'en'}, timeout=900, ).json() # every row carries a status; failures are records, not exceptions ok = [r for r in rows if r.get("status") == "ok"] print(len(ok), "rows delivered")
const ACTOR = "steadydata~google-autocomplete"; const url = `https://api.apify.com/v2/acts/${ACTOR}/run-sync-get-dataset-items` + `?token=${process.env.APIFY_TOKEN}`; const rows = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({"keywords": ["air fryer", "electric bike"], "country": "US", "language": "en"}), }).then((r) => r.json()); // one object per delivered row, same shape every time console.log(rows.filter((r) => r.status === "ok").length, "rows");
Point an MCP client at Apify's hosted server with this dataset in the tools list, or run our own server locally. The field explanations in the table below travel with the schema, so your agent reads them straight from the platform instead of from this page.
https://mcp.apify.com?tools=steadydata/google-autocomplete # the tool arrives in your agent as steadydata--google-autocomplete
| Field | Type | Name | What it does |
|---|---|---|---|
keywordsrequired | array of string | Seed keywords | 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 | string | Country | Two-letter country code that sets the market (gl), e.g. US, GB, NL, DE. |
language | string | Language | Interface language (hl), e.g. en, nl, de. Suggestions follow the language people type in that market. |
expandAlphabet | boolean | Expand a to z | Also query '<seed> a' to '<seed> z' (26 extra calls per seed) for long-tail keywords. |
expandQuestions | boolean | Expand with question words | Also query 'how <seed>', 'what <seed>', 'why <seed>', 'best <seed>', '<seed> vs' and similar (10 extra calls per seed). Question words are English; set them yourself via customPrefixes for other languages. |
customPrefixes | array of string | Custom prefixes or suffixes | 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 | integer | Max suggestions per seed | Cost ceiling per seed across all expansions. One delivered suggestion is one charged event. |
{
"keyword": string | null,
"query": string | null,
"suggestion": string | null,
"rank": integer | null,
"relevance": integer | null,
"suggestionType": string | null,
"country": string | null,
"language": string | null,
"status": string | null,
"input": string | null,
"errorCode": string | null,
"error": string | null
}| Field | Type | When it is filled |
|---|---|---|
keyword | string, null | |
query | string, null | |
suggestion | string, null | |
rank | integer, null | |
relevance | integer, null | |
suggestionType | string, null | |
country | string, null | |
language | string, null | |
status | string, null | Either 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged. |
input | string, null | The input this row was built from, so a row can always be traced back. |
errorCode | string, null | Filled on an error row only; a delivered row leaves it empty. |
error | string, null | Filled on an error row only; a delivered row leaves it empty. |
Ads from Google's Ads Transparency Center per advertiser domain or advertiser id, per country or worldwide: creative id, advertiser name, preview image or preview URL, first and last shown dates and a link to the ad. Up to 200 advertisers per run. Pay only for delivered ads.
$1.40 per 1,000 · Ad listedFlight options from Google Flights for up to 200 searches per run: price, airlines, flight numbers, departure and arrival times, duration, stops and layover airports, aircraft and CO2 estimate, in Google's order. One-way or round trip, any cabin class and currency. Pay only for delivered flights.
$1.40 per 1,000 · Flight listedThe cheapest fare per departure day for a route over a date range, from Google Flights: one row per day with the lowest price, airline, stops and duration, so you see when it is cheap. Up to 100 routes, up to 60 days each. Pay per delivered day.
$3.00 per 1,000 · Day pricedAlready using this one? Ratings are the first thing other buyers look at, and this dataset has none yet. If it does a job for you, a rating on its Apify page is the one thing that helps. It takes a minute and it is the only thing we ask for.