GET
Google Travel Prices API
Pull a date-specific Google Travel rate and booking partners in one currency.
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 to target an explicit stay; 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.
Endpoint URL
GET https://api.stayapi.com/v1/google_travel/prices
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| entity_token | string | Required | Durable Google Travel token returned by Resolve or Search. Use this token, not hotel_id, for property drilldowns. |
| check_in | date | Optional | Check-in date (YYYY-MM-DD). Must be supplied with check_out. |
| check_out | date | Optional | Check-out date (YYYY-MM-DD). Must be supplied with check_in. |
| 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, Similar, and Nearby requests.