Search and retrieve hotel listings based on various criteria. Get hotel metadata including names, addresses, ratings, amenities, and images for display in your application.
Provide search criteria (city, coordinates+radius, placeId, or hotelIds). Returns matching hotels with complete metadata.
Country code ISO-2 code - example (SG)
Name of the city
Name of the hotel (loose match, case-insensitive, e.g. 'hilton')
Specifies the number of rows to skip before starting to return rows
Specifies the maximum number of results to return. By default, this is set to 200, even if not explicitly defined. If a higher limit is specified, the maximum allowed is 5000 results
Retrieve only the hotels that have been updated since the provided date and time (using the RFC3339 format)
Longitude geo coordinates
Latitude geo coordinates
radius in meters (min 1000m)
Search term for AI search. Uses semantic search to find hotels matching the query intent. Examples: 'Romantic getaway with Italian vibes in London near the London Eye', 'Hotels near the Eiffel tower'
request timeout in seconds
ZIP code of the location
Minimum rating of the hotel. e.g. 8.6
Minimum number of reviews. e.g. 100
Comma-separated list of facilities. e.g. '1,2,3'
Comma-separated list of hotel types. e.g. '201,204,208'
Comma-separated list of hotel chain ids. e.g. '14675,14677'
If true, only hotels with all the specified facilities will be returned
Comma-separated list of star ratings. Note: star ratings have 2 allowed decimals '.0' and '.5' from 1 to 5. e.g. '3.5,4.0,5.0'
Unique ID of a place retrieved from the /data/places endpoint. When provided, the API fetches place details and searches for hotels within a 1km radius of the place location center, or a specific hotel when the placeId refers to a property. The response includes a place object containing the place information used in the search.
The language code, indicating in which language the results should be returned. e.g. 'fr'
Comma-separated list of hotel IDs (e.g., 'lp1897,lp1343') to fetch specific hotels by their IDs. This is a valid main query parameter that can be used instead of other search criteria.
If true, only hotels with advanced accessibility will be returned
OK
An array of unique hotel identifiers that match the specified filters or query parameters, allowing quick reference to specific hotels.
The total number of hotels retrieved based on the applied filters or query parameters.
Place information used in the search. Only present when placeId parameter is used.