GET
Google Travel Prices API
Pull the current Google Travel rate and booking partners in one currency.
Overview
Get Google's current nightly price, usual-price band, and partner booking offers for one hotel.
Contract note
Google chooses the default stay dates returned as check_in and check_out. price_range.typical can fall below low or above high, and a hotel without a bookable rate for those dates 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. |
| 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 | Google's selected default stay dates. |
| 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.