Where is the documentation for the Google Suggest API? [closed]

Question

Is there any official documentation on the Google Suggest API?

All my searches for the Google suggest API show pages with either outdated info or non-working scripts.

For example, at google.com, as soon as you type in "app", Google suggests Apple, Applebees, etc.

Answer 1

As you can imagine, it's changed.

The newer URL is now http://clients1.google.com/complete/search?hl=en&output=toolbar&q=YOURSEARCHTERM

Or even more recent: http://suggestqueries.google.com/complete/search?output=toolbar&hl=en&q=YOURSEARCHTERM

Answer 2

Summary of working examples:

From this question working example:

http://suggestqueries.google.com/complete/search?output=toolbar&hl=en&q=theory

---

From this question working example:

http://suggestqueries.google.com/complete/search?output=firefox&q=theory

---

From mhawksey comment above working example:

http://google.com/complete/search?client=chrome&q=theory

Here client=chrome can be changed to other browser client. For example for Firefox it will look like:

http://google.com/complete/search?client=firefox&q=theory

---

From mahoor13 comment above working example:

google.com/complete/search?output=toolbar&q=theory

---

From dhiraj-pandey answer "if you want country specific suggests, you need to add &gl= in the url". That only works with links for toolbar!

So for example working country specific example for India will be:

google.com/complete/search?output=toolbar&q=theory&gl=in

---

To separate words use %20 or + between them. For example:

http://suggestqueries.google.com/complete/search?output=toolbar&hl=en&q=a%20mykeyword

or

http://suggestqueries.google.com/complete/search?output=toolbar&hl=en&q=a+mykeyword

---

Also from here it possible to get two suggestions with YQL (first sugestion chuck norris, second steven seagal):

select * from xml where url in ( ‘http://google.com/complete/search?output=toolbar&q=chuck+norris’, ‘http://google.com/complete/search?output=toolbar&q=steven+seagal’ ) 

Using above code gives:

http://query.yahooapis.com/v1/public/yql?q=select%20*%20from%20xml%20where%20url%20in%20%28%27http%3A%2F%2Fgoogle.com%2Fcomplete%2Fsearch%3Foutput%3Dtoolbar%26q%3Dchuck%2Bnorris%27%2C%27http%3A%2F%2Fgoogle.com%2Fcomplete%2Fsearch%3Foutput%3Dtoolbar%26q%3Dsteven%2Bseagal%27%29&format=xml&diagnostics=false

---

Some info from google about suggestions: http://www.google.com/support/enterprise/static/gsa/docs/admin/70/gsa_doc_set/xml_reference/query_suggestion.html