Google Hotels API
google_hotelsGet hotel and vacation-rental prices, ratings, and availability for any destination and date, with filters for price, rating, and more.
Instructions
Get hotel and vacation-rental prices, ratings and availability from Google Hotels.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | No | Return raw HTML instead of parsed JSON. (API default: false) | |
| query | Yes | Hotel search query (e.g. 'hotels in Paris'). | |
| adults | No | Number of adults. (API default: 2) | |
| rating | No | Min rating: 7=3.5+, 8=4.0+, 9=4.5+. | |
| country | No | Two-letter ISO country code to geo-target results (e.g. us, gb, in, de). (API default: us) | |
| sort_by | No | Sort: 3=lowest price, 8=highest rating, 13=most reviews. | |
| children | No | Number of children. (API default: 0) | |
| currency | No | Pricing currency. (API default: USD) | |
| language | No | Result language code (e.g. en, es, fr, de). (API default: en) | |
| max_price | No | Maximum price filter. | |
| min_price | No | Minimum price filter. | |
| hotel_class | No | Star class filter (2-5), comma-separated. | |
| check_in_date | Yes | Check-in date, YYYY-MM-DD. | |
| children_ages | No | Comma-separated child ages 1-17 (e.g. '5,8,10'). | |
| check_out_date | Yes | Check-out date, YYYY-MM-DD. | |
| property_token | No | Token for detailed property information. | |
| next_page_token | No | Pagination token from a previous response. | |
| vacation_rentals | No | Search vacation rentals instead of hotels. (API default: false) | |
| free_cancellation | No | Only show free-cancellation options. |