Google Hotels
GET /google/v1/hotelsGoogle 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
| Name | Type | Description |
|---|---|---|
qrequired | string | Example: hotels in paris |
check_in | string | YYYY-MM-DD (with check_out). Example: 2026-12-10 |
check_out | string | YYYY-MM-DD. Example: 2026-12-12 |
adults | integer | 1-9. |
children | integer | 0-9. |
hotel_class | string | Comma-separated star classes, 2-5 (e.g. 4,5). Example: 4,5 |
amenities | string | Comma-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_cancellation | boolean | 1: properties with free cancellation. |
special_offers | boolean | 1: properties with deals. |
eco_certified | boolean | 1: eco-certified properties. |
vacation_rentals | boolean | 1: vacation rentals instead of hotels. |
bedrooms | integer | Vacation rentals: at least this many bedrooms (1-9). |
bathrooms | integer | Vacation rentals: at least this many bathrooms (1-9). |
min_price | number | Lowest nightly price (in `currency`). |
max_price | number | Highest nightly price (in `currency`). |
rating | number | Minimum guest rating, e.g. 4 or 4.5. |
sort | relevance | lowest_price | highest_rating | most_reviewed | relevance (default), lowest_price, highest_rating, most_reviewed. |
currency | string | Currency of the prices, e.g. USD (default), EUR, GBP, INR. |
country | string | e.g. us. |
language | string | e.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.