JustSERPDocs
Google

Google Hotels Property

One hotel's page on Google Hotels, answered as the document with `property`: address, phone, class, rating, price, nearby places and what the hotel says about itself.

GET
/v1/google/hotels/property

One hotel's page on Google Hotels, answered as the document with property: address, phone, class, rating, price, nearby places and what the hotel says about itself. Works for hotels. total_price is the price Google shows for the stay. Not answered: top_things_to_know, people_also_viewed, vacation_rentals_nearby, prices by booking site, the reviews, the amenities. free_cancellation and expanded_search are refused (400).

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
property_token*string

From google_hotels or google_hotels_autocomplete.

Match^[A-Za-z0-9_-]+$
check_in_date*string

YYYY-MM-DD.

Formatdate
check_out_date*string

YYYY-MM-DD.

Formatdate
adults?integer
Range1 <= value <= 10
Default2
children_ages?string

Ages 1 to 17, comma-separated.

currency?string
Default"USD"
hl?string
Default"en"
gl?string
Default"us"

Response Body

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

application/json
  1. response

The first three keys of every parsed 200 (the answer is the document itself, no success/data envelope): what the search was (search_metadata), what it asked (search_parameters), the parser's own search_information ({} when it has none). The engine's blocks follow, at the same level. An engine whose answer is a list puts it under results.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

property?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/hotels/property?property_token=ChcI7IjNo8qKrsIdGgsvZy8xdGZkN3h3eRAB&check_in_date=2026-12-12&check_out_date=2026-12-15'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "property": {    "type": "string",    "property_token": "string",    "data_id": "string",    "name": "string",    "link": "string",    "description": "string",    "gps_coordinates": {      "latitude": 0,      "longitude": 0    },    "country": "string",    "check_in_time": "string",    "check_out_time": "string",    "price_per_night": {      "price": "string",      "extracted_price": 0    },    "total_price": {      "price": "string",      "extracted_price": 0    },    "deal": "string",    "nearby_places": [      {        "name": "string",        "transportations": [          {            "type": "string",            "duration": "string"          }        ]      }    ],    "hotel_class": "string",    "extracted_hotel_class": 0,    "rating": 0,    "reviews": 0,    "reviews_histogram": {      "property1": 0,      "property2": 0    },    "images": [      {        "thumbnail": "string"      }    ],    "address": "string",    "phone": "string",    "about": [      "string"    ]  }}

Google Hotels GET

A page of hotels and vacation rentals for a search on Google Hotels, answered as the document with `properties`: price per night and for the stay, rating, class, nearby places and pictures.

Google Hotels Autocomplete GET

What the Google Hotels search box suggests for some typed letters, answered as the document with `suggestions`: five at most, places (`destination`) and hotels (`hotel`).