# Google Autocomplete API — $0.0002/suggestion

> Google Autocomplete API: Raw Google autocomplete suggestions for one seed query. $0.0002 per delivered suggestion, nothing delivered means nothing charged.

[Home](https://quanticdata.io/)/[Collectors](https://quanticdata.io/collectors/)/*Google Autocomplete API*

# Google Autocomplete API

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.

[Get my free API key](https://app.quanticdata.io/register) [See the request](/collectors/google-autocomplete-api/#integration)

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

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
```

**$0.0002 / suggestion**10,000 suggestions on the free $2 every month

**Semantic input**query, country, lang — no URL lists

**Up to 20**suggestions per run, pagination handled for you

**No browser**read over HTTP/TLS — cheaper and faster than rendering

On this page: [What it is](/collectors/google-autocomplete-api/#what) [Output fields](/collectors/google-autocomplete-api/#output) [Inputs](/collectors/google-autocomplete-api/#input) [Pricing](/collectors/google-autocomplete-api/#pricing) [Integration](/collectors/google-autocomplete-api/#integration) [Use cases](/collectors/google-autocomplete-api/#use-cases) [Versus the alternatives](/collectors/google-autocomplete-api/#compare) [FAQ](/collectors/google-autocomplete-api/#faq)

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

Input is meaning, not a URL *query* *country* *lang* *max_results*

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

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

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.0002**per delivered suggestion*$0.16 per 1,000 delivered suggestions*

**10,000 suggestions**on the free allowance*$2 every month, no card*

**Zero rows**zero charge*blocks, captchas and retries are on us*

**−30%**on volume tiers*the 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

Most popular

### 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](https://quanticdata.io/web-data-api-for-ai/). Prices are launch pricing read live from the billing config — `GET /v1/scraper/collectors` returns the price your key actually pays.

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 quantumproxies \
  -e QUANTUMPROXIES_API_KEY=qd_live_your_key_here \
  -- npx -y quantumproxies-mcp

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

## 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 |

## FAQ

Questions we get about the Google Autocomplete API.

[Something else? Ask us →](mailto:hello@quanticdata.io)

### 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](https://quanticdata.io/collectors/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`.

[Get my free API key](https://app.quanticdata.io/register)

Related: [All 65 collectors](https://quanticdata.io/collectors/) [Keyword research API](https://quanticdata.io/collectors/keyword-research-api/) [Google search results API](https://quanticdata.io/collectors/google-search-results-api/) [Google News API](https://quanticdata.io/collectors/google-news-api/) [Google Events API](https://quanticdata.io/collectors/google-events-api/) [Google Flights API](https://quanticdata.io/collectors/google-flights-api/) [Documentation](https://quanticdata.io/docs/)

---

Source: https://quanticdata.io/collectors/google-autocomplete-api/ · Site index for AI: https://quanticdata.io/llms.txt