Skip to main content
POST
Google Hotel Details API

Google Hotel Details

Everything Google Hotels knows about one property in a single row. You get the address, phone and website, check-in time, the amenity list, scores for the neighborhood’s transit, restaurants and attractions, the share of reviews at each star rating, the topics guests praise or complain about, ratings on other review sites, and the price each booking site charges for your stay. Ideal for rate-parity checks, competitive set analysis or a richer hotel page in your own product.
Provide a hotel_id from the id field of Google Hotels Search. Add check_in and check_out (YYYY-MM-DD) to get offers for those dates; otherwise offers are for one night from tomorrow. Each request costs 2 credits and returns one row; an unknown hotel_id returns no rows and is still charged.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a hotel_id from Google Hotels Search. The result is one row with the hotel's address, contact details, amenities, location scores, guest ratings, review topics and the offers from each booking site for the chosen stay.

hotel_id
string
required

Hotel ID from the id field of Google Hotels Search results.

Minimum string length: 1
callback_url
string<uri>
check_in
string

Check-in date in YYYY-MM-DD format. Defaults to tomorrow; give check_out with it.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
check_out
string

Check-out date in YYYY-MM-DD format, after check_in and at most 30 nights later.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
currency
string

Three-letter currency code for prices, such as USD or EUR.

Pattern: ^[A-Za-z]{3}$
language_code
string
default:en

Language code of the results. Defaults to en.

Required string length: 2 - 10
location_code
integer
default:2840

Search market location code. Defaults to 2840 (United States).

Required range: x >= 1

Response

Task accepted

code
integer
data
object