The Google Hotels API provides real-time access to structured Google Hotels search results, including property listings, prices, ratings, amenities, and pagination.
Minimum price per night, in the selected currency.
maxPrice
-
No
Maximum price per night, in the selected currency.
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.
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.
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
brands
-
No
Comma-separated list of brand IDs to filter by. Brand IDs are returned in the response under brands for the same query.
hotelClass
-
No
Comma-separated list of hotel star classes to include (e.g., 2,3,4,5).
freeCancellation
-
No
Show only properties offering free cancellation.
specialOffers
-
No
Show only properties with special offers.
ecoCertified
-
No
Show only eco-certified properties.
vacationRentals
-
No
Search vacation rentals instead of hotels.
bedrooms
-
No
Minimum number of bedrooms (vacation rentals only).
bathrooms
-
No
Minimum number of bathrooms (vacation rentals only).
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.