--- title: "Retrieve a list of hotels" method: GET path: "/data/hotels" tags: ["Hotels"] --- # Retrieve a list of hotels `GET /data/hotels` ## Request - Base URL: `https://api.liteapi.travel/v3.0` - URL: `https://api.liteapi.travel/v3.0/data/hotels` - Auth: API key in header `X-API-Key` ## 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 - `countryCode` string - `cityName` string - `hotelName` string - `offset` integer - `limit` integer - `lastUpdatedAt` string - `longitude` number - `latitude` number - `radius` integer - `aiSearch` string - `timeout` number, float - `zip` string - `minRating` number, float - `minReviewsCount` number - `facilityIds` string - `hotelTypeIds` string - `chainIds` string - `strictFacilitiesFiltering` boolean - `starRating` string - `placeId` string - `language` string - `hotelIds` string - `advancedAccessibilityOnly` boolean ## Response `200` OK - object - `data` object[] - `id` string, required: Unique identifier of the hotel - `name` string, required: Name of the hotel - `hotelDescription` string: A brief description of the hotel and its facilities - `currency` string: The currency code used for hotel pricing (e.g., USD, EUR) - `country` string, required: The country where the hotel is located - `city` string, required: The city where the hotel is situated - `latitude` number, required: The latitude coordinate of the hotel's location - `longitude` number, required: The longitude coordinate of the hotel's location - `address` string: The street address of the hotel - `zip` string: The postal code of the hotel - `main_photo` string: The main image representing the hotel - `thumbnail` string: A smaller version of the main photo used for previews - `stars` number: The hotel's star rating (e.g., 3, 4, 5 stars) - `hotelTypeId` number: The unique identifier for the hotel's category or type - `chainId` number: The unique identifier of the hotel chain - `chain` string: The name of the hotel chain, if applicable (e.g., Hilton, Marriott). - `accessibilityAttributes` object: A compact representation of the hotel's accessibility features. - `attributes` string[], required: List of attributes representing boolean fields that are true. - `showerChair` string, nullable: Information about the availability of a shower chair. - `entranceType` string, nullable: Type of entrance, e.g., automatic or manual. - `petFriendly` string, required: Indicates if the hotel is pet-friendly. - `rampAngle` number, float, required: The angle of the ramp in degrees. - `rampLength` number, float, required: The length of the ramp in meters. - `entranceDoorWidth` integer, required: Width of the entrance door in centimeters. - `roomMaxGuestsNumber` integer, required: Maximum number of guests allowed in the room. - `distanceFromTheElevatorToTheAccessibleRoom` number, float, required: Distance from the elevator to the accessible room in meters. - `rohId` integer: Room of House ID - unique identifier for the hotel property. - `deletedAt` string: Timestamp indicating when hotel is deleted in our system - `score` number, float: Similarity score (0.0-1.0) indicating how well the hotel name matches the search query when searching by placeId. Higher scores indicate better matches. Only present when placeId parameter is used. - `rating` number, float: The average guest rating for the hotel (e.g., 8.5 out of 10) - `reviewCount` integer: The total number of guest reviews for the hotel - `facilityIds` integer[]: Array of facility IDs available at the hotel (e.g., [1, 2, 3] representing WiFi, Pool, Gym) - `hotelIds` string[]: An array of unique hotel identifiers that match the specified filters or query parameters, allowing quick reference to specific hotels. - `total` integer: The total number of hotels retrieved based on the applied filters or query parameters. - `place` object: Place information used in the search. Only present when placeId parameter is used. - `placeId` string: The place ID used in the search - `displayName` string: The display name of the place (e.g., 'Marriott New York JFK Airport') - `addressComponents` object[]: A list of address components, each representing a part of the address such as country, city, or postal code. - `languageCode` string: The language code for the address component (e.g., 'en', 'en-US'). - `longText` string: The full text of the address component (e.g., 'France'). - `shortText` string: The abbreviated or short text for the address component (e.g., 'FR'). - `types` string[]: A list of types describing the address component (e.g., 'country', 'political'). - `location` object: The geographic coordinates of the place. - `latitude` number: The latitude of the location. - `longitude` number: The longitude of the location. - `viewport` object: The recommended viewport for displaying the place, defined by high and low latitude/longitude bounds. - `high` object: The northeast corner of the viewport. - `latitude` number: The latitude of the high (northeast) corner. - `longitude` number: The longitude of the high (northeast) corner. - `low` object: The southwest corner of the viewport. - `latitude` number: The latitude of the low (southwest) corner. - `longitude` number: The longitude of the low (southwest) corner. - `types` string[]: A list of place types (e.g., 'lodging', 'hotel', 'establishment'). ## Other responses - `400`: Bad Request - `401`: Unauthorized --- [API](https://skmtc.dev/liteapi/apis/api-hotel-data.md) - [All operations](https://skmtc.dev/liteapi/apis/api-hotel-data/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-hotel-data/revisions/f89f11b63949?raw)