Skip to content
Gridlode
Docs · Reference

Google Hotels Search

GET /v1/travel/google/hotels2 credits / requestcache 60 min

Hotels and vacation rentals from a Google Hotels search for a destination, dates, guest count and currency, as a signed-out visitor sees them. You get one results page, usually about 20 properties. For each property: name, property token and IDs, type (hotel or vacation rental), category, hotel class, rating, review count, star breakdown, review topics, the lowest price as the card displays it, that price per night and for the whole stay before and with taxes, taxes, fees, Google's deal note ("24% less than usual"), coordinates, check-in and check-out times, amenities, nearby places with travel times, photos, website and a Google Hotels link. Vacation rentals also include booking-site offers and links. The response also includes the search location and Google's total result count. Without dates, Google prices a one-night stay starting soon. Hotel amenities are always returned as English labels. Street addresses, per-site prices for hotels, further result pages, and Google's sort and filter options are not available here. Phrases in q such as '5 star hotels in Rome' or 'vacation rentals in Lisbon' are interpreted by Google. Blocked or failed requests are free.

Query parameters

q
string · required
What Google Hotels should search, as typed in its search box: a destination ('Paris', 'hotels in Lisbon'), an area or landmark ('hotels near Times Square'), or a phrase such as 'vacation rentals in Austin' or '5 star hotels in Rome'.
check_in
string
Check-in date, YYYY-MM-DD. Without dates Google prices a one-night stay starting tomorrow or the day after.
Default: null
check_out
string
Check-out date, YYYY-MM-DD (at most 30 nights after check_in).
Default: null
adults
integer
Number of adult guests.
Default: 2
currency
string
Price currency, e.g. USD, EUR, GBP.
Default: "USD"
hl
string
Interface language, e.g. en, fr, pt-BR (names, descriptions and texts).
Default: "en"
gl
string
Country the search is made from (2-letter code); also picks the proxy exit country.
Default: "us"
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/travel/google/hotels?q=hotels%20in%20Paris" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Hotels Search API page.