Google Autocomplete
Google's suggestion lists across five surfaces — web, YouTube, Images, local and Scholar. The same endpoint returns a different universe per surface.
Web
Web search autocomplete, with relevance scores.
/v1/autocomplete:google/webParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Seed text to complete. Required. |
| lang | string | query | UI language, two letters. Default id. |
| region | string | query | Country bias, two letters. Default ID. |
| count | number | query | Cap the list. Default: everything the upstream returns. |
Example response
{"project":"autocomplete:google", "data": {"count":15, "items": [ {"text":"cara membuat cv","relevance":601 }, {"text":"cara membuat npwp online","relevance":600 }, {"text":"cara membuat cv lamaran kerja","relevance":562 }, {"text":"cara membuat email baru","relevance":561 }, {"text":"cara membuat npwp","relevance":560 }, {"text":"cara membuat daftar isi otomatis","relevance":559 }, {"text":"cara membuat martabak manis","relevance":558 }, {"text":"cara membuat cireng","relevance":557 } ],"query":"cara membuat","locale":"id-ID","surface":"web","provider":"google" },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
YouTube
Video search autocomplete.
/v1/autocomplete:google/youtubeParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Seed text to complete. Required. |
| lang | string | query | UI language, two letters. Default id. |
| count | number | query | Cap the list. Default: everything the upstream returns. |
Example response
{"project":"autocomplete:google", "data": {"count":14, "items": [ {"text":"cara membuat layangan" }, {"text":"cara membuat daftar isi otomatis word" }, {"text":"cara membuat donat" }, {"text":"cara membuat slime" }, {"text":"cara membuat cireng" }, {"text":"cara membuat bolu pisang" }, {"text":"cara membuat pesawat dari kertas" }, {"text":"cara membuat cilok" } ],"query":"cara membuat","locale":"id","surface":"youtube","provider":"google" },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Images
Image search autocomplete.
/v1/autocomplete:google/imagesParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Seed text to complete. Required. |
| lang | string | query | UI language, two letters. Default id. |
| count | number | query | Cap the list. Default: everything the upstream returns. |
Example response
{"project":"autocomplete:google", "data": {"count":10, "items": [ {"text":"kucing" }, {"text":"kucing persia","highlighted":"kucing<b> persia</b>" }, {"text":"kucing lucu","highlighted":"kucing<b> lucu</b>" }, {"text":"kucing anggora","highlighted":"kucing<b> anggora</b>" }, {"text":"kucing munchkin","highlighted":"kucing<b> munchkin</b>" }, {"text":"kucing hutan","highlighted":"kucing<b> hutan</b>" }, {"text":"kucing bengal","highlighted":"kucing<b> bengal</b>" }, {"text":"kucing siam","highlighted":"kucing<b> siam</b>" } ],"query":"kucing","locale":"id","surface":"images","provider":"google" },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Local
Places and local search autocomplete.
/v1/autocomplete:google/localParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Seed text to complete. Required. |
| lang | string | query | UI language, two letters. Default id. |
| count | number | query | Cap the list. Default: everything the upstream returns. |
Example response
{"project":"autocomplete:google", "data": {"count":10, "items": [ {"text":"restoran jakarta","highlighted":"restoran<b> jakarta</b>" }, {"text":"restoran jakarta selatan","highlighted":"restoran<b> jakarta selatan</b>" }, {"text":"restoran terdekat","highlighted":"restoran<b> terdekat</b>" }, {"text":"restoran" }, {"text":"restoran terdekat dari lokasi saya","highlighted":"restoran<b> terdekat dari lokasi saya</b>" }, {"text":"restoran jakarta timur","highlighted":"restoran<b> jakarta timur</b>" }, {"text":"restoran kelapa gading","highlighted":"restoran<b> kelapa gading</b>" }, {"text":"restoran di grand indonesia","highlighted":"restoran<b> di grand indonesia</b>" } ],"query":"restoran","locale":"id","surface":"local","provider":"google" },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Scholar
Academic search autocomplete.
/v1/autocomplete:google/scholarParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Seed text to complete. Required. |
| lang | string | query | UI language, two letters. Default id. |
| count | number | query | Cap the list. Default: everything the upstream returns. |
Example response
{"project":"autocomplete:google", "data": {"count":10, "items": [ {"text":"machine learning algorithms" }, {"text":"machine learning approach" }, {"text":"machine learning techniques" }, {"text":"machine learning models" }, {"text":"machine learning methods" }, {"text":"machine learning applications" }, {"text":"machine learning review" }, {"text":"machine learning classification" } ],"query":"machine learning","locale":"id","surface":"scholar","provider":"google" },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Expand
Expand one seed into the many real queries people type — the seed with every letter, question word and preposition appended, deduplicated.
/v1/autocomplete:google/expandParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Seed to expand. Required. |
| surface | enum | query | Which Google suggestion universe to expand. Default web. One of web, youtube, images, local, scholar. |
| modifiers | enum | query | Which modifier sets to append. Default all. One of all, alphabet, questions, prepositions, digits. |
| lang | enum | query | Language for the question and preposition sets. Default id. One of id, en. |
| count | number | query | Cap the returned list. Default: every unique query found. |
Example response
{"project":"autocomplete:google", "data": {"seed":"cara membuat","count":558, "items": [ {"via":"alphabet","text":"cara membuat akun google" }, {"via":"alphabet","text":"cara membuat akun" }, {"via":"alphabet","text":"cara membuat akun spmb" }, {"via":"alphabet","text":"cara membuat akun google baru" }, {"via":"alphabet","text":"cara membuat anak" }, {"via":"alphabet","text":"cara membuat ayam kecap" }, {"via":"alphabet","text":"cara membuat akta kelahiran" }, {"via":"alphabet","text":"cara membuat asinan buah" } ],"locale":"id","surface":"web","provider":"google","modifiers":"all","truncated":false,"variantsTried":44,"variantsFailed":0 },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "autocomplete:google", "web", { q: "cara membuat", lang: "id", region: "ID", count: 10 });
Google Autocomplete
Google's suggestion lists across five surfaces — web, YouTube, Images, local and Scholar. The same endpoint returns a different universe per surface.
Web search autocomplete, with relevance scores.
/v1/…google/webTry it
Parameters
q
string · query · required
Seed text to complete.
lang
string · query · optional
UI language, two letters. Default id.
region
string · query · optional
Country bias, two letters. Default ID.
count
number · query · optional
Cap the list. Default: everything the upstream returns.
Example response
{"project":"autocomplete:google", "data": {"count":15, "items": [ {"text":"cara membuat cv","relevance":601 }, {"text":"cara membuat npwp online","relevance":600 }, {"text":"cara membuat cv lamaran kerja","relevance":562 }, {"text":"cara membuat email baru","relevance":561 }, {"text":"cara membuat npwp","relevance":560 }, {"text":"cara membuat daftar isi otomatis","relevance":559 }, {"text":"cara membuat martabak manis","relevance":558 }, {"text":"cara membuat cireng","relevance":557 } ],"query":"cara membuat","locale":"id-ID","surface":"web","provider":"google" },"timestamp":"2026-10-02T01:56:17Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "autocomplete:google", "web", { q: "cara membuat", lang: "id", region: "ID", count: 10 });