Search modes
limit is clamped to a maximum of 100. offset must be zero or greater. Both are applied after the search mode is resolved.GET /api/v1/reference/search
Search the reference hotel inventory.Query parameters
string
Fuzzy search query for hotel name. When present, name search mode is used and geographic/filter parameters are ignored.
number
Latitude for geographic search. Must be combined with
lon and radius.number
Longitude for geographic search. Must be combined with
lat and radius.number
Search radius in kilometers. Must be greater than 0.
string
Filter results by country name. Case-insensitive. Can be combined with any search mode.
string
Filter results by region. Applicable in name and filter-based modes.
string
Filter results by city name.
number
Minimum star rating (e.g.
3, 4.5). Applied in filter-based mode.number
default:"20"
Maximum number of results to return. Clamped to the range 1 to 100.
number
default:"0"
Number of results to skip for pagination.
Response
object[]
Array of matching reference hotel objects.
number
Total number of results matching the query before pagination.
Examples
GET /api/v1/reference/search/advanced
Advanced search with additional filters and sorting options.Query parameters
string
Hotel name query string.
string
Filter by country name.
string
Filter by city name.
number
Minimum star rating.
boolean
When
true, only return hotels that have latitude and longitude values.string
default:"name"
Field to sort by. Accepted values:
name, rating, created.string
default:"asc"
Sort direction. Accepted values:
asc, desc.number
default:"20"
Maximum number of results. Clamped to 1 to 100.
number
default:"0"
Pagination offset.