Sub-80ms Search Suggest & Typeahead Autocomplete API
GET/v1/autocomplete1 Credit / query (0 if empty)($0.0001 / query ($0.06–$0.10 / 1K queries))· Updated 2026-11-14
Return real-time search query completions for any seed prefix, country, and language in under 80ms. Ideal for programmatic SEO long-tail discovery, e-commerce search boxes, and LLM RAG query fan-out.
Parameters
qstringrequiredSeed query prefix to expand (e.g., 'best crm for' or 'how to migrate from').
Example:
best crm forcountrystringTwo-letter ISO country code (default us).
Example:
uslangstringISO 639-1 language code (default en).
Example:
enlimitinteger (1 to 20)Maximum number of autocomplete suggestions to return (1 to 20, default 10).
Example:
10
Example Request (cURL / Python / JavaScript)
curl "https://api.searchdataapi.com/v1/autocomplete?q=best+crm+for" \
-H "x-api-key: sr_live_your_api_key"import requests
res = requests.get(
"https://api.searchdataapi.com/v1/autocomplete?q=best+crm+for",
headers={"x-api-key": "sr_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.searchdataapi.com/v1/autocomplete?q=best+crm+for", {
headers: { "x-api-key": "sr_live_your_api_key" },
});
const data = await res.json();
console.log(data);Live Response Preview
{
"code": 0,
"provider": "https://searchdataapi.com",
"status": "ok",
"msg": "success",
"data": {
"query": "best crm for",
"country": "US",
"lang": "en",
"count": 5,
"suggestions": [
{
"position": 1,
"suggestion": "best crm for real estate agents",
"completion_suffix": "real estate agents",
"word_count": 6
},
{
"position": 2,
"suggestion": "best crm for small business",
"completion_suffix": "small business",
"word_count": 5
},
{
"position": 3,
"suggestion": "best crm for real estate",
"completion_suffix": "real estate",
"word_count": 5
},
{
"position": 4,
"suggestion": "best crm for mortgage loan officers",
"completion_suffix": "mortgage loan officers",
"word_count": 6
},
{
"position": 5,
"suggestion": "best crm for service based business",
"completion_suffix": "service based business",
"word_count": 6
}
]
},
"meta": {
"request_id": "68bd83ac-33c2-4f2f-8ef2-bf91b3a40119",
"endpoint": "/v1/autocomplete",
"count": 5,
"credits_charged": 1,
"cached": false,
"took_ms": 46
}
}Response Fields
Ordered list of real-time typeahead suggestions with completion suffixes.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | Example: https://searchdataapi.com |
status | string | Example: ok |
msg | string | Example: success |
data | object | |
query | string | Input prefix. |
country | string | ISO country code. |
lang | string | ISO language code. |
count | integer | Number of suggestions returned. |
suggestions | array of AutocompleteItem | |
position | integer | 1-based suggestion rank. |
suggestion | string | Full completed query string. |
completion_suffix | string | Appended suffix beyond input prefix. |
word_count | integer | Word count of suggestion. |
meta | ResponseMeta | |
request_id | string | Unique UUIDv4 trace identifier. |
endpoint | string | Normalized /v1/* endpoint path. |
count | integer | Number of primary items returned. |
credits_charged | integer | Credits deducted (0 on empty or error). |
cached | boolean | Whether served from L1/L2 edge cache. |
took_ms | integer | End-to-end gateway latency in milliseconds. |
Status Codes
- 200
- Ordered list of real-time typeahead suggestions with completion suffixes.