Google's Query Suggest API
Some things (!) by Google are undocumented. Well, that's one of them :-)
Topics
What is Google's Query Suggest API+
Google's Query Suggest API is an internal, undocumented API used by Google to provide autocomplete suggestions when users type search queries into the search bar. It is what powers the Google Autocomplete feature in Google Search, Google Chrome, and other Google products.
How Google's Query Suggest API work?+
When a user starts typing a search query, Google's Query Suggest API returns a list of predicted search terms based on:
Popular searches related to the typed query
Search trends based on real-time data
User’s previous searches (if signed in)
Geographical location (if enabled)
Popular searches related to the typed query
Search trends based on real-time data
User’s previous searches (if signed in)
Geographical location (if enabled)
How can I access Google's Query Suggest API?+
Though Google does not officially document or provide public access to the API, developers have found that it can be accessed via the following endpoint:
Replace
The
Example Response
If you query:
https://suggestqueries.google.com/complete/search?client=firefox&q=apple
The response is typically in JSON format:
This means that Google suggests:
"apple store"
"apple watch"
"apple id"
"apple music"
"apple stock"
https://suggestqueries.google.com/complete/search?client=firefox&q=your_query
Replace
your_query with the term you want suggestions for.The
client=firefox parameter is often used because it was historically required to get JSON-formatted results.Example Response
If you query:
https://suggestqueries.google.com/complete/search?client=firefox&q=apple
The response is typically in JSON format:
["apple", ["apple store", "apple watch", "apple id", "apple music", "apple stock"]]
This means that Google suggests:
"apple store"
"apple watch"
"apple id"
"apple music"
"apple stock"
Known limitations+
As an unofficial API call, it comes with some limitations
Unofficial API: Google can change or block access at any time.
Rate Limits: Excessive requests might get blocked.
No Official Documentation provided: No support or guarantees of stability.
Unofficial API: Google can change or block access at any time.
Rate Limits: Excessive requests might get blocked.
No Official Documentation provided: No support or guarantees of stability.
How Google's Query Suggest API+
When a user starts typing a search query, Google's Query Suggest API returns a list of predicted search terms based on:
Popular searches related to the typed query
Search trends based on real-time data
User’s previous searches (if signed in)
Geographical location (if enabled)
Popular searches related to the typed query
Search trends based on real-time data
User’s previous searches (if signed in)
Geographical location (if enabled)
How can I access Google's Query Suggest API+
Though Google does not officially document or provide public access to the API, developers have found that it can be accessed via the following endpoint:
Replace
The
Example Response
If you query:
https://suggestqueries.google.com/complete/search?client=firefox&q=apple
The response is typically in JSON format:
This means that Google suggests:
"apple store"
"apple watch"
"apple id"
"apple music"
"apple stock"
https://suggestqueries.google.com/complete/search?client=firefox&q=your_query
Replace
your_query with the term you want suggestions for.The
client=firefox parameter is often used because it was historically required to get JSON-formatted results.Example Response
If you query:
https://suggestqueries.google.com/complete/search?client=firefox&q=apple
The response is typically in JSON format:
["apple", ["apple store", "apple watch", "apple id", "apple music", "apple stock"]]
This means that Google suggests:
"apple store"
"apple watch"
"apple id"
"apple music"
"apple stock"