Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google Hotels

GET /google/v1/hotels
Test this endpoint

Google Hotels results (google.com/travel): price from, currency, rating, reviews, hotel class and type, amenities, deal, images and property_token (= entity_id, for /google/v1/hotels/property, /prices and /reviews). Prices are in the requested currency (currency in the response says which one Google showed; currency_note when it differs). Dates, guests, hotel class, amenities, free cancellation, deals, eco-certified, vacation rentals, bedrooms and bathrooms go to Google; min_price, max_price, rating and sort apply to the page of results Google returned (about 18-20 properties, one page). The filters used are echoed in filters. Every response includes credits_used: the credits this call cost.

Each call costs 3 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: hotels in paris
check_instringYYYY-MM-DD (with check_out). Example: 2026-12-10
check_outstringYYYY-MM-DD. Example: 2026-12-12
adultsinteger1-9.
childreninteger0-9.
hotel_classstringComma-separated star classes, 2-5 (e.g. 4,5). Example: 4,5
amenitiesstringComma-separated: pool, indoor_pool, outdoor_pool, spa, free_wifi, free_breakfast, free_parking, parking, pet_friendly, fitness_center, restaurant, bar, air_conditioning, airport_shuttle, kitchen, beach_access, hot_tub, ev_charger, kid_friendly, wheelchair_accessible, room_service, washer, all_inclusive.
free_cancellationboolean1: properties with free cancellation.
special_offersboolean1: properties with deals.
eco_certifiedboolean1: eco-certified properties.
vacation_rentalsboolean1: vacation rentals instead of hotels.
bedroomsintegerVacation rentals: at least this many bedrooms (1-9).
bathroomsintegerVacation rentals: at least this many bathrooms (1-9).
min_pricenumberLowest nightly price (in `currency`).
max_pricenumberHighest nightly price (in `currency`).
ratingnumberMinimum guest rating, e.g. 4 or 4.5.
sortrelevance | lowest_price | highest_rating | most_reviewedrelevance (default), lowest_price, highest_rating, most_reviewed.
currencystringCurrency of the prices, e.g. USD (default), EUR, GBP, INR.
countrystringe.g. us.
languagestringe.g. en.

Every endpoint also takes: raw、fields、fresh、output、records

No sample yet

This endpoint has no published sample. Use “Test this endpoint” to run it in the console playground.