google_hotels
Retrieves Google Hotels search results including property listings, pricing, ratings, and amenities. Supports filters like dates, price range, rating, and property type, with pagination and detailed property info.
Instructions
Retrieves Google Hotels search results including property listings, pricing, ratings, amenities, and detailed property info (via property_token). Costs 5 API credits per request. [Credits: 5 API credits per request] Notes: check_in_date/check_out_date use YYYY-MM-DD. Several hotel-only filters (brands, hotel_class, free_cancellation, special_offers, eco_certified) are not supported when vacation_rentals=true; conversely bedrooms/bathrooms only apply when vacation_rentals=true. Pagination via next_page_token; use property_token for a detail lookup on a single property. Returns: { ads: [{title, source, price, reviews, overall_rating, amenities: [], hotel_class, free_cancellation}] } (sample truncated in docs; likely also includes a properties/hotels results array alongside ads)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | No | Return the full HTML of the Google page. (default: false) | |
| query | Yes | Search query, anything you would normally type into a standard Google Hotels search. | |
| adults | No | Number of adults. (default: 2) | |
| brands | No | Brand ID(s) to focus the search on. Single: '33'; multiple: '33,67,101'. Not supported for Vacation Rentals. | |
| rating | No | Minimum rating filter. Allowed values: 7 (3.5+), 8 (4.0+), 9 (4.5+). | |
| country | No | Two-letter country code for the Google search (e.g. US, UK, FR). (default: us) | |
| sort_by | No | Sort order. Default is Relevance. Allowed values: 3 (lowest price), 8 (highest rating), 13 (most reviews). | |
| bedrooms | No | Minimum number of bedrooms. Vacation Rentals only. (default: false) | |
| children | No | Number of children. (default: 0) | |
| currency | No | Currency for returned prices. (default: USD) | |
| language | No | Language of the results, e.g. en, es, fr, de. (default: en) | |
| amenities | No | Only include listings with the selected amenities; see the Google Hotels / Vacation Rentals Amenities reference pages for allowed values. | |
| bathrooms | No | Minimum number of bathrooms. Vacation Rentals only. (default: false) | |
| max_price | No | Maximum price in the results range. | |
| min_price | No | Minimum price in the results range. | |
| hotel_class | No | Filter to specific star ratings. Allowed values: 2, 3, 4, 5. Not supported for Vacation Rentals. | |
| check_in_date | Yes | Check-in date, format YYYY-MM-DD, e.g. 2025-08-15. | |
| children_ages | No | Ages of children, valid range 1-17. Single child: '5'; multiple: '5,8,10'. | |
| eco_certified | No | Only include eco-certified listings. Not supported for Vacation Rentals. | |
| check_out_date | Yes | Check-out date, format YYYY-MM-DD, e.g. 2025-08-16. | |
| property_token | No | Retrieves detailed property information (name, address, phone number, prices, nearby places, etc.) for a specific property. | |
| property_types | No | Property type(s) to include; see the Google Hotels / Vacation Rentals Property Types reference pages for allowed values. | |
| special_offers | No | Only include listings with special offers. Not available for Vacation Rentals. | |
| next_page_token | No | Token to fetch the next page of results. | |
| vacation_rentals | No | Search Vacation Rentals instead of Hotels. (default: false) | |
| free_cancellation | No | Only include listings offering free cancellation. Not available for Vacation Rentals. |