GET
Google Travel Search API
Find hotel cards by destination or query and get tokens for property drilldowns.
Copy for your AI agent
Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.
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 in YYYY-MM-DD format. Check-in must be today or later and check-out must be after check-in. 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 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. |
| 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 | About 20 hotel cards per page. Each card has name, entity_token, hotel_id, rating, review_count, hotel_class, price (nightly), total_price (whole stay), latitude and longitude, description, photo and photos, amenities (English labels), check_in_time / check_out_time, deal, location_rating, website, and feature_id. Fields Google does not show for a card are null or empty. |
| total_count | integer|null | Google's total number of results for the query. |
| 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, Rooms, Similar, and Nearby requests.