Google search and market data

Google Autocomplete Keywords Scraper: A to Z expansion

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.

$0.35per 1,000 · Suggestion listed

One autocomplete suggestion delivered. Seeds that return nothing are never charged; no start fee.

Call it from your code

curl
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"}'
python
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")
javascript
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");

Use it in an agent

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.

mcp url
https://mcp.apify.com?tools=steadydata/google-autocomplete

# the tool arrives in your agent as steadydata--google-autocomplete

Input

FieldTypeNameWhat it does
keywords
required
array of stringSeed keywordsOne seed keyword per row (up to 500). Each seed is one input; a seed without suggestions comes back as a free error record.
countrystringCountryTwo-letter country code that sets the market (gl), e.g. US, GB, NL, DE.
languagestringLanguageInterface language (hl), e.g. en, nl, de. Suggestions follow the language people type in that market.
expandAlphabetbooleanExpand a to zAlso query '<seed> a' to '<seed> z' (26 extra calls per seed) for long-tail keywords.
expandQuestionsbooleanExpand with question wordsAlso 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.
customPrefixesarray of stringCustom prefixes or suffixesYour own expansions, one per row. Use * for the seed position, e.g. 'beste *' or '* kopen'. Without * the text is used as a suffix.
maxSuggestionsPerKeywordintegerMax suggestions per seedCost ceiling per seed across all expansions. One delivered suggestion is one charged event.

What you get back

output schema, one object per delivered row
{
  "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
}
FieldTypeWhen it is filled
keywordstring, null
querystring, null
suggestionstring, null
rankinteger, null
relevanceinteger, null
suggestionTypestring, null
countrystring, null
languagestring, null
statusstring, nullEither 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged.
inputstring, nullThe input this row was built from, so a row can always be traced back.
errorCodestring, nullFilled on an error row only; a delivered row leaves it empty.
errorstring, nullFilled on an error row only; a delivered row leaves it empty.

Related datasets

Already 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.

Open the Apify page