GET
Google Travel Search API
Find hotel cards by destination or query and get tokens for property drilldowns.
Overview
Search Google Travel by free text, dates, occupancy, currency, and Google's native guest-rating thresholds.
Contract note
Supply check_in and check_out together. Pages can overlap slightly, so de-duplicate results by entity_token. Use entity_token, not hotel_id, for follow-up calls.
Endpoint URL
GET https://api.stayapi.com/v1/google_travel/search
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Required | Free-text search, for example hotels in Lisbon. |
| 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. |
| min_rating | number | Optional | Google guest-rating threshold: 3.5, 4.0, or 4.5. |
| currency | string | Optional | ISO 4217 currency code. Default: USD. |
| page | integer | Optional | 1-indexed results page. Default: 1. |
| hl | string | Optional | UI language code. Default: en. |
| gl | string | Optional | Region or country code. Default: us. |
Response schema
| Field | Type | Description |
|---|---|---|
| results | array | Hotel cards with name, entity_token, hotel_id, rating, class, price, coordinates, description, and photo. |
| page / has_more | integer / boolean | Pagination state. An empty page or has_more: false marks the end. |
| check_in / check_out / adults | mixed | Normalized search context used by Google Travel. |
| min_rating / currency | number / string | Applied rating threshold and money currency. |
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.