Some things (!) by Google are undocumented. Well, that’s one of them 🙂
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.
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)
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: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”
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.
