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…). |
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
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.