Google Autocomplete API

SEO & keywords · v1.0.0 · google_autocomplete

$0.0002 / suggestion

$0.16 / 1K · pay per delivered suggestion

A Google Autocomplete API that returns the search box's own suggestions for one seed. Send a partial query, a country and a language, and get back every completion Google would offer, each with its relevance score and type flag — billed per suggestion delivered.

By Aldo Morese, founder of QuanticData · Published Aug 21, 2026 · Updated Sep 3, 2026

Run in dashboard See the request

$0.0002 per delivered suggestion · $2 free every month · Failed runs never billed

What it does

What a Google Autocomplete API does

Autocomplete is Google telling you, live, which continuations it considers likely for a prefix — no volume attached, but not a model either. This endpoint makes the single call to that surface and returns the raw list: the suggestion, Google's relevance ordering and the type (QUERY, ENTITY…), exactly as the box would render them.

Two things get built wrong here. The endpoint is defended per IP, so a bare script is throttled within a handful of calls and the exit rotation is the part you are really paying for. And this is search-query autocomplete, not the Places address autocomplete developers often land on by mistake — it completes what people search, not postal addresses. For a–z, question and comparison expansion of a seed, the keyword_ideas collector wraps this same primitive.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

Input	Type	Required	What it does
`query`	string	yes	The partial query to complete, e.g. "proxy ser".
`country`	string	no	ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
`lang`	string	no	Interface language (hl), e.g. en, it, de.
`max_results`	integer	no	How many suggestions to deliver at most (1–20). You pay only for delivered suggestions.

Outputs — 5 fields, one row per suggestion

What one suggestion looks like

Every delivered suggestion carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

Field	Type	What it holds
`rank`	integer	Suggestion order as Google returns it.
`suggestion`	string	The suggested query.
`relevance`	integer · nullable	Google's relevance score, when provided.
`type`	string · nullable	Suggestion kind (QUERY, ENTITY…), when provided.
`seed`	string	The seed that produced this suggestion.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/google_autocomplete/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/google_autocomplete/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"web scraping","country":"us","lang":"en","max_results":10}'

import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/google_autocomplete/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "query": "web scraping",
        "country": "us",
        "lang": "en",
        "max_results": 10
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)

const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/google_autocomplete/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"query":"web scraping","country":"us","lang":"en","max_results":10}),
  },
);
const { payload } = await res.json();
console.table(payload.results);

claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the google_autocomplete collector with query="web scraping" and country="us"

Example response

POST /v1/scraper/collectors/google_autocomplete/run

$ curl $QD/google_autocomplete/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"query": "web scraping", "country": "us", "lang": "en", "max_results": 10}'
{ "status": "done", "count": 10,
  "results": [
    {
      "suggestion": "…",
      "relevance": …,
      "type": "…",
      "seed": "…" } ],
  "cost": 0.002 }
# 10 suggestions × $0.0002 · nothing delivered, nothing charged

Try it

Google Autocomplete, running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key

Google Autocomplete API: from query, country and lang, QuanticData reads the search suggestions and returns one row per suggestion with suggestion, relevance and seed, at $0.0002 per delivered suggestion. — You send query and country; the run goes out through a residential exit and comes back as suggestions with rank, suggestion and relevance — 5 fields on every row — and you are billed $0.0002 for each suggestion actually delivered, nothing for a run that delivers none.

$0.0002 / suggestion10,000 suggestions on the free $2 every month

Semantic inputquery, country, lang — no URL lists

Up to 20suggestions per run, pagination handled for you

No browserread over HTTP/TLS — cheaper and faster than rendering

Pricing

Google Autocomplete API pricing

$0.0002 per delivered suggestion. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 10,000 suggestions before you spend anything.

$0.0002per delivered suggestion$0.16 per 1,000 delivered suggestions

10,000 suggestionson the free allowance$2 every month, no card

Zero rowszero chargeblocks, captchas and retries are on us

−30%on volume tiersthe catalog returns your key's price

Pay as you go

$0/mo

$2 free credit / month
60 requests / min
List unit prices

Starter

$19/mo

$15 free credit / month
300 requests / min
10% off unit prices

Growth

$79/mo

$50 free credit / month
600 requests / min
20% off unit prices

Scale

$299/mo

$250 free credit / month
1,200 requests / min
30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

What people build with the Google Autocomplete API

Three shapes of work this endpoint was designed around.

Live suggestion UIs

Back your own search box with Google's completions for a country without exposing an internal endpoint to the browser.

Seed validation

Check what Google actually offers for a term before it goes into a content brief or an ad group.

Entity discovery

Read the type flag to separate plain queries from entity suggestions when mapping a topic.

Google Autocomplete API versus rolling your own

The differences that actually cost time when you build this in-house.

	DIY scraper	This collector
What you send	A partial query plus an endpoint you keep unblocked	A seed, a country, a language
Autocomplete kind	Places address autocomplete, by mistake	Search-query suggestions, as the box shows them
Scale	One seed at a time	This primitive, or keyword_ideas for full a–z expansion

What people search for

Live autocomplete demand around Google Autocomplete, pulled with our own Keyword ideas collector.

Google Autocomplete API: the POST to the google_autocomplete collector, 10 suggestions delivered and the bill, 10 × $0.0002 = $0.002 in usage.cost_usd; zero suggestions would cost $0. — The same call you would paste into a terminal: a Bearer key, query, country and lang in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many suggestions arrived and usage.cost_usd is $0.002, which is 10 × $0.0002. A run that delivers nothing costs nothing. The key is good for 60 req/min on the free tier.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the Google Autocomplete API.

Something else? Ask us

Do I need a Google API key?

No. You send a seed and a country to the collector; the call to Google's endpoint, the exit and the parsing are handled for you, and you are billed per suggestion returned rather than against a key quota.

Is this the same as Places address autocomplete?

No, and it is a common mix-up. Google's Places API completes postal addresses; this completes search queries — what a person types into the search box. City and street completion is a different product.

How is this different from the keyword research API?

This is the single-seed primitive: one seed, one list. The keyword research API wraps it and expands a seed across the alphabet, question words, prepositions and comparisons, de-duplicating across all of them. Use this when you want one clean suggestion set, that when you want the whole long-tail.

Does it return search volume?

No. Autocomplete carries a relevance ordering, not a volume figure, so the collector returns the rank and Google's relevance score and never a made-up number of searches.

Is there a free Google Autocomplete API?

Every account gets $2 of credit every month with no card, which is about 10,000 delivered suggestions on this endpoint at $0.0002 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

How much does one run cost?

Multiply the rows you actually receive by $0.0002. A run capped at 20 suggestions — the maximum for this collector — costs $0.004 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

Run the Google Autocomplete API now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Run in dashboard