JustSERPDocs
Google

Google Local

Google's Places list for a query: twenty places a page with rating, address and, in the order layout (food chains), ids, phone and website.

GET
/v1/google/local

Google's Places list for a query: twenty places a page with rating, address and, in the order layout (food chains), ids, phone and website. Answers the document: search_metadata, search_parameters, search_information, local_results and pagination. The default layout carries the kgmid only: data_id, place_id and ludocid are in the order layout's markup alone. The hotels layout (Google's travel cards) answers no local_results. Desktop only.

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 to search for.

Length1 <= length
location?string

A canonical place name, e.g. "Austin,Texas,United States" (becomes Google's uule). Not with uule.

uule?string

Google's own location value (w+CAIQ...). Not with location.

latitude?number

With longitude; places the search by Google's UULE cookie.

Range-90 <= value <= 90
longitude?number

With latitude.

Range-180 <= value <= 180
gl?string

Country of the search, two letters.

Default"us"
hl?string

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

Default"en"
device?"desktop"

Only desktop: mobile and tablet are a 400.

Default"desktop"
Value in"desktop"
page?integer

Results page; Google's start is (page - 1) * 20.

Range1 <= value <= 100
Default1

Response Body

The results page, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Local document. A block is present only when the page has it.

search_metadata?
search_parameters?

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

search_information?
local_results?array<>
pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/local?q=coffee+shops&location=Austin%2CTexas%2CUnited+States'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string"  },  "local_results": [    {      "position": 0,      "title": "string",      "kgmid": "string",      "rating": 0,      "reviews": 0,      "price": "string",      "extracted_price": {        "min": 0,        "max": 0      },      "type": "string",      "address": "string",      "comment": "string",      "image": "string",      "is_closed": true,      "data_id": "string",      "place_id": "string",      "ludocid": "string",      "phone": "string",      "website": "string",      "direction": "string",      "order": {},      "extensions": [        "string"      ]    }  ],  "pagination": {    "current": 0,    "previous": "string",    "next": "string"  }}