JustSERPDocs
Google

Google Autocomplete

The completions Google's suggest service gives for what has been typed.

GET
/v1/google/autocomplete

The completions Google's suggest service gives for what has been typed. client picks the service and with it the answer's form: gws-wiz (Google's home page; an entity has title, description and thumbnail), chrome-omni (Chrome's address bar; relevance, QUERY or NAVIGATION types and a verbatim_relevance), chrome, firefox, safari. Answers the document: search_metadata, search_parameters, search_information and suggestions.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

What has been typed so far.

Length1 <= length <= 2000
client?string

The suggest client: gws-wiz (Google's home page), chrome-omni (Chrome's address bar), chrome, firefox, safari. It changes the suggestions and the answer's form. A value that is not a plain word is a 400.

Default"gws-wiz"
cp?integer

The cursor position in q, 0 to its length (400 outside). Default: the end of q.

Range0 <= value
gl?string

Country of the search, two letters.

Default"us"
hl?string

Interface language, e.g. en, pt-br.

Default"en"

Response Body

The suggestions, as the document. When the answer could not be parsed, the usual envelope.

application/json
  1. response

The Autocomplete document.

search_metadata?
search_parameters?

The request as sent, with the defaults that were used.

search_information?
suggestions?array<>
verbatim_relevance?integer

The Chrome clients' score of the query as typed.

[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/autocomplete?q=ama&client=gws-wiz'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {},  "suggestions": [    {      "value": "string",      "type": 0,      "title": "string",      "description": "string",      "thumbnail": "string",      "relevance": 0    }  ],  "verbatim_relevance": 0}