v1
latestOpenAPI 3.0.02026-07-247251950.2 KBRetrieve a list of hotels
Overview
Search and retrieve hotel listings based on various criteria. Get hotel metadata including names, addresses, ratings, amenities, and images for display in your application.
When to Use
- Hotel listings - Display hotel search results
- Location-based search - Find hotels by city, coordinates, or Place ID
- Hotel discovery - Browse hotels in specific areas
- Metadata retrieval - Get hotel information for display
What You Get
- Hotel list - Matching hotels with complete metadata
- Basic information - Names, addresses, ratings, and locations
- Amenities - Available facilities and features
- Images - Hotel photos for display
- Identifiers - Hotel IDs for use in rate searches
Search Options
- By city - Search hotels in a specific city
- By coordinates - Find hotels near latitude/longitude with radius
- By Place ID - Get hotels within a specific place boundary
- By hotel IDs - Retrieve specific hotels by their IDs
Quick Start
Provide search criteria (city, coordinates+radius, placeId, or hotelIds). Returns matching hotels with complete metadata.
Query parameters
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
Response
OK