Google Travel Prices API
Pull a date-specific Google Travel rate and booking partners in one currency.
Copy for your AI agent
Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.
Overview
Get Google's nightly price, usual-price band, and partner booking offers for one hotel and stay.
Contract note
Supply check_in and check_out together in YYYY-MM-DD format to target an explicit stay. Check-in must be today or later and check-out must be after check-in; omit both to let Google choose defaults. price_range.typical can fall below low or above high, and a hotel without a bookable rate returns 404. For room types, cancellation terms, and breakfast per rate, use Rooms with the same parameters.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| entity_token | string | Required | Opaque Google Travel token returned by Resolve, Search, or Similar. Tokens can be short or long (for example, a short token is CgoI0PjV-Zzk1JpgEAE). Use this token, not hotel_id, for property drilldowns. |
| check_in | date | Optional | Check-in date (YYYY-MM-DD). Must be today or later and supplied with check_out. |
| check_out | date | Optional | Check-out date (YYYY-MM-DD). Must be after check_in and supplied with it. |
| adults | integer | Optional | Number of adults, 1 to 10. Default: 2. |
| currency | string | Optional | ISO 4217 code shaping every money field. Default: USD. |
| hl | string | Optional | UI language code. Default: en. |
| gl | string | Optional | Region or country code. Default: us. |
Response schema
| Field | Type | Description |
|---|---|---|
| check_in / check_out | date | Requested stay dates, or Google's selected defaults when omitted. |
| currency / price | mixed | Requested currency and current nightly price. |
| price_range | object | Low, typical, and high price-band values. |
| offers | array | Booking partner, redirect link, and displayed price. |
Identifier workflow
Resolve once, reuse the token
Resolve a hotel name or run Search to get an entity_token. Cache that token and use it for Summary, Info, Photos, Prices, Rooms, Similar, and Nearby requests.