Retrieve a list of hotels

get

https://api.liteapi.travel/v3.0/data/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

countryCode

string

Country code ISO-2 code - example (SG)

cityName

string

Name of the city

hotelName

string

Name of the hotel (loose match, case-insensitive, e.g. 'hilton')

offset

integer

Specifies the number of rows to skip before starting to return rows

limit

integer

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

lastUpdatedAt

string

Retrieve only the hotels that have been updated since the provided date and time (using the RFC3339 format)

longitude

number

Longitude geo coordinates

latitude

number

Latitude geo coordinates

radius

integer

radius in meters (min 1000m)

aiSearch

string

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'

timeout

float

request timeout in seconds

zip

string

ZIP code of the location

minRating

float

Minimum rating of the hotel. e.g. 8.6

minReviewsCount

number

Minimum number of reviews. e.g. 100

facilityIds

string

Comma-separated list of facilities. e.g. '1,2,3'

hotelTypeIds

string

Comma-separated list of hotel types. e.g. '201,204,208'

chainIds

string

Comma-separated list of hotel chain ids. e.g. '14675,14677'

strictFacilitiesFiltering

boolean

If true, only hotels with all the specified facilities will be returned

starRating

string

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'

placeId

string

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.

language

string

The language code, indicating in which language the results should be returned. e.g. 'fr'

hotelIds

string

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.

advancedAccessibilityOnly

boolean

If true, only hotels with advanced accessibility will be returned

Responses

200OK

400Bad Request

401Unauthorized