This endpoint allows searching for hotels with location and hotelids.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Search: Response Keys
| Key | Description |
|---|---|
| traceId | Unique ID of search session |
| hotelId | Unique ID of the hotel |
| hotelName | Hotel name |
| heroImage | Main image of the hotel, meant for the search results card |
| boardBasis | Meal plan of the rate shown for the hotel |
| refundability | Whether the rate can be cancelled for free |
| cancellationPolicy | Cancellation terms for the rate, made up of one or more rules |
| finalRate | Final price of the hotel's lead rate for the hotel |
Note: tags cannot be used on a fresh search — the internal tag IDs are only available from the /search API's own response. To filter by tags, you must first run a search without this filter, read the tag IDs off the results, and then re-search (or refine) passing those IDs back in filterBy.tags
Nationality codes:
Download the countries and nationality list (CSV) for the full list of countries with their code values. Send the code value (for example IN for India or US for United States) in the nationality key. Do not send the country name or the nationality text from the file.
Bad Request. One or more request parameters are invalid or missing.
Unauthorized. The access token is missing or invalid.
Not Found. The requested resource could not be located.
Bad Request. Client Side Error in Request Body.