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.
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.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - 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)
{
"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.
| 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…). Defaults to the country a location ends in. |
language
|
string | en | Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…). |
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 /v1/autocomplete reference. Queue up to 100 requests at half price with POST /v1/batches.
Use cases
What people build with the Google Autocomplete API
Keyword research
Expand seed terms into long-tail keywords real users type.
Agent query expansion
Turn a vague question into the specific queries people actually search.
Market localization
Compare suggestions across countries and languages before you translate content.
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.
| 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
Keep exploring
Related APIs and integrations
Start building
Start with the Google Autocomplete API
2,500 free credits, then 1,000 every month. No credit card.