google_travel_hotels: GET /
hasdata_google_travel_hotels_getGoogleHotelsSearch Google Hotels for hotels and vacation rentals by dates, guests, location, and filters like price, rating, amenities, and property type. Returns structured rates, reviews, and property details.
Instructions
Get Google Hotels Results
Searches Google Hotels for hotels and vacation rentals with check-in/check-out dates, guest mix (adults, children with ages), localization (domain, country, language, currency), and advanced filters: price range, property types, amenities, minimum rating, brands, hotel class, free cancellation, special offers, eco-certified, vacation rentals only, bedrooms, bathrooms, and sort order (lowest price, highest rating, most reviewed). Returns per-property name, description, link, GPS coordinates, check-in/out times, rate per night and total rate, price comparisons across sources, hotel class, overall rating, reviews, location rating, images, amenities, nearby places, deals, eco-certification, and pagination tokens. Use for travel research agents, hotel rate monitoring, OTA dashboards, and competitive analysis of accommodations across markets.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The search query for Google Hotels (e.g., a city, neighborhood, or hotel name). | |
| gl | No | The two-letter country code for the country you want to limit the search to. Provide one exact documented value (245 allowed), e.g. `ac`, `af`. | |
| hl | No | The two-letter language code for the language you want to use for the search. Provide one exact documented value (159 allowed), e.g. `af`, `ak`. | |
| adults | No | Number of adult guests (1-6). | |
| brands | No | Comma-separated list of brand IDs to filter by. Brand IDs are returned in the response under `brands` for the same query. | |
| rating | No | Filter by minimum overall guest rating. Options: - `threePointFivePlus` — 3.5 stars or higher - `fourPlus` — 4.0 stars or higher - `fourPointFivePlus` — 4.5 stars or higher | |
| sortBy | No | Sort hotel results. Options: - `lowestPrice` — lowest price - `highestRating` — highest rating - `mostReviewed` — most reviewed | |
| bedrooms | No | Minimum number of bedrooms (vacation rentals only). | |
| children | No | Number of child guests (1-5). Total guests (adults + children) cannot exceed 6. | |
| currency | No | Parameter defines the currency of the returned prices Provide one exact documented value (71 allowed), e.g. `ALL`, `DZD`. | |
| maxPrice | No | Maximum price per night, in the selected currency. | |
| minPrice | No | Minimum price per night, in the selected currency. | |
| amenity__ | No | List of amenities to filter by (e.g., `hotelFreeWifi,hotelPool`). Values prefixed `hotel*` apply when searching hotels (the default mode). Values prefixed `rental*` apply when `vacationRentals=true`. The two sets are disjoint because Google Hotels exposes different amenity catalogs for each mode — pass values matching the mode you're querying. | |
| bathrooms | No | Minimum number of bathrooms (vacation rentals only). | |
| hotelClass | No | Comma-separated list of hotel star classes to include (e.g., `2,3,4,5`). | |
| checkInDate | Yes | The check-in date in 'yyyy-MM-dd' format. | |
| checkOutDate | Yes | The check-out date in 'yyyy-MM-dd' format. | |
| childrenAges | No | Comma-separated list of children ages (e.g., `5,8,12`). Must match the number of children. | |
| ecoCertified | No | Show only eco-certified properties. | |
| nextPageToken | No | Token to fetch the next page of hotel results. Returned in the `pagination` field of a previous response. | |
| propertyToken | No | Token used to retrieve details for a specific property. Returned in each property in the results. | |
| specialOffers | No | Show only properties with special offers. | |
| propertyType__ | No | List of property types to filter by (e.g., `hotelResort,hotelMotel`). Values prefixed `hotel*` apply when searching hotels (the default mode). Values prefixed `rental*` apply when `vacationRentals=true`. The two sets are disjoint because Google Hotels exposes different property-type catalogs for each mode — pass values matching the mode you're querying. | |
| vacationRentals | No | Search vacation rentals instead of hotels. | |
| freeCancellation | No | Show only properties offering free cancellation. |