Skip to main content
POST /v1/data/google-hotels/hotels/run Pricing: $0.002 per hotel ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
Location.
date
required
Check In Date as a date (YYYY-MM-DD).
date
required
Check Out Date as a date (YYYY-MM-DD).
string[]
One or more hotel class. One request reads them all.
string
default:"relevance"
Sort By to use. Relevance by default.Allowed values: relevance (Relevance), price_low (Price (Low to High)), price_high (Price (High to Low)), rating (Rating), most_reviewed (Most reviewed), distance (Distance).
integer
default:"2"
Adults as a whole number.Min 1; max 9.
string
default:"USD"
Three-letter currency code for prices, e.g. USD, EUR, GBP, INR. Defaults to USD.
integer
default:"100"
How many hotels to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one hotel, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For Booking.com’s own listing detail use booking/listings; for TripAdvisor ratings use tripadvisor/hotels.