Skip to content

New Official SDKs for TypeScript, Python and Go

SerpKite
Get API key

POST /v1/autocomplete

Google Autocomplete API

The suggestions Google shows as someone types, for any prefix, country and language. Half a credit per call, built for keyword research and query expansion.

Get a free API key Try in playground
0.5 credits per call 2,500 free credits, no card Failed calls are free

Overview

What the Google Autocomplete API does

The Google Autocomplete API returns Google's type-ahead suggestions for a partial query. It's the cheapest way to see how real people phrase searches in a market.

At 0.5 credits per call it's priced for volume: expand a seed keyword with every letter of the alphabet ("how to learn a", "how to learn b"…) for 13 credits.

What you get

suggestions[] array
Each item has a value: the full suggested query.
request object
Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
meta object
request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.

Request

curl https://api.serpkite.com/v1/autocomplete \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"how to learn","country":"us"}'

Response (illustrative, placeholder domains)

200 OK · application/json
{
  "request": {
    "endpoint": "autocomplete",
    "engine": "google",
    "q": "how to learn",
    "country": "us",
    "language": "en"
  },
  "results": [
    {
      "value": "how to learn python"
    },
    {
      "value": "how to learn spanish"
    },
    {
      "value": "how to learn piano"
    },
    {
      "value": "how to learn to code"
    },
    {
      "value": "how to learn guitar"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 0.5,
    "engine": "google",
    "cached": false,
    "latency_ms": 812,
    "resolved_urls": true,
    "parse_quality": "ok"
  }
}

Every response also carries X-Credits-Used, X-Credits-Remaining, X-Cache and X-Tokens-Estimate headers. Run this query in the playground

Reference

Parameters

The parameters /v1/autocomplete accepts, in the JSON body or the query string.

Google Autocomplete API parameters
Name Type Default Description
q required string – The search query. Required. Up to 2,048 characters.
country string us Country to search from, as a two-letter ISO code (us, gb, de, in…).
language string en Interface language, as a language code (en, de, fr, pt-BR…).
format string json Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown.

Full reference, error codes and headers are in the API docs. Send a JSON array of up to 100 request objects to run them in one call.

Use cases

What people build with the Google Autocomplete API

01

Keyword research

Expand seed terms into long-tail keywords real users type.

02

Agent query expansion

Turn a vague question into the specific queries people actually search.

03

Market localization

Compare suggestions across countries and languages before you translate content.

04

Trend spotting

New suggestions appearing for a prefix are an early demand signal.

Pricing

Google Autocomplete API pricing

Cost per call

0.5 credits

per call

  • From $0.30 per 1,000 calls at volume.
  • Credits never expire. No subscription.
  • Failed, empty and blocked calls are refunded.
  • 2,500 free credits = 5,000 calls, then 1,000 credits a month.

For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.

See all pricing
Google Autocomplete API cost per pack
Pack Price Per 1k credits Per 1k calls Calls per pack
Starter $10 $1.00 $0.50 20,000
Growth $50 $0.80 $0.40 125,000
Pro $300 $0.60 $0.30 1,000,000

FAQ

Google Autocomplete API: common questions

Start building

Start with the Google Autocomplete API

2,500 free credits, then 1,000 every month. No credit card.