List results
GET/hotels/results
Pass the searchToken from /hotels/search as the token query parameter to get page 1. Each response that has another page includes nextToken. This call usually answers in 2–5 seconds.
What is in a page
hotels holds up to 30 properties. Page 1 is often a few short of 30. bestOption is the cheapest seller on the before-tax stay price, which is also what sortBy=price orders by. totalPrice on that option includes taxes.
availableFilters describes this search. minStars, minRating, maxPrice, freeCancellation, amenity ids, and booking-site ids (as providers) can be sent on a new /hotels/search. The id on a hotel is what /hotels/details wants as resultId, and what /hotels/reviews wants as hotelId. Keep the token - details needs it too. Reviews do not.
Parameters
Query parameters.
tokenstringRequired
A searchToken from /hotels/search for page 1, or a nextToken from the previous page. There is no page number to set.
Returns
A successful response, captured live.
{
"hotels": [
{
"id": "5782",
"name": "Threadneedles Autograph Collection",
"description": "Experience refined luxury combined with incredible convenience at our boutique hotel in London. Perfectly situated within the former Victorian City Bank, it features 5-star guest rooms and suites with distinctive, tim...",
"propertyType": {
"code": "hotel",
"name": "Hotel"
},
"stars": 5,
"usesStarRating": true,
"rating": {
"score": 8.9,
"label": "Very good",
"reviewCount": 504
},
"location": {
"city": "London",
"neighborhood": "City of London",
"distance": "2.0 mi",
"distanceFrom": "from city center",
"lat": 51.51415,
"lng": -0.085678
},
"phone": "+44 207 657 8080",
"image": "https://content.r9cdn.net/rimg/himg/1b/39/42/leonardo-5782-3599011-366479.jpg?width=968&height=607&crop=true",
"imageCount": 15,
"amenities": [
"24hr front desk",
"Air-conditioned",
"Airport shuttle",
"Elevator",
"Hairdryer",
"Hot tub"
],
"badges": [
{
"type": "freeWifi",
"label": "Free WiFi"
}
],
"highlight": "Near observatory, near station, complimentary mini-bar",
"bestOption": {
"provider": "Marriott Bonvoy",
"price": {
"amount": 753,
"currency": "USD",
"formatted": "$753"
},
"totalPrice": {
"amount": 753,
"currency": "USD",
"formatted": "$753"
},
"rateType": "memberOnly",
"freebies": null,
"taxEstimated": false,
"instantBooking": true,
"privateDeal": false
},
"optionCount": 8,
"usualPrice": {
"amount": 899.15,
"currency": "USD",
"formatted": "$899"
},
"viewRank": 0
},
{
"id": "2222365",
"name": "Montcalm East, Autograph Collection",
"description": "See life in a whole new light at Montcalm East, a standout luxury hotel in Shoreditch, central London. Just a short stroll from Old Street station and close to Liverpool Street, this innovative hotel brings East Londo...",
"propertyType": {
"code": "hotel",
"name": "Hotel"
},
"stars": 5,
"usesStarRating": true,
"rating": {
"score": 8.8,
"label": "Very good",
"reviewCount": 4264
},
"location": {
"city": "London",
"neighborhood": "Hackney",
"distance": "2.5 mi",
"distanceFrom": "from city center",
"lat": 51.527763,
"lng": -0.088972
},
"phone": "+44 203 837 3000",
"image": "https://content.r9cdn.net/rimg/himg/bb/01/77/leonardo-2222365-1447407-933236.jpg?width=968&height=607&crop=true",
"imageCount": 15,
"amenities": [
"24hr front desk",
"Air-conditioned",
"Airport shuttle",
"Business center",
"EV charging station",
"Elevator"
],
"badges": [
{
"type": "freeWifi",
"label": "Free WiFi"
}
],
"highlight": "Near park, near station, great stay",
"bestOption": {
"provider": "Booking.com",
"price": {
"amount": 600,
"currency": "USD",
"formatted": "$600"
},
"totalPrice": {
"amount": 720,
"currency": "USD",
"formatted": "$720"
},
"rateType": "bestAvailable",
"freebies": [
"Free cancellation"
],
"taxEstimated": false,
"instantBooking": true,
"privateDeal": false
},
"optionCount": 7,
"usualPrice": {
"amount": 622.82,
"currency": "USD",
"formatted": "$623"
},
"viewRank": 1
}
],
"page": 1,
"hasMore": true,
"expiresIn": 3596,
"totalResults": 4687,
"nextToken": "eyJwIjoyLCJzIjoiNjgyMmZiMzMyMzA4NDZjNGFiZWRiM2Q2OTRiM2YyNjgiLCJ2IjoxfQ",
"destination": {
"name": "London, England, United Kingdom",
"shortName": "London",
"cityId": "28501",
"country": "United Kingdom",
"countryCode": "GB"
},
"availableFilters": {
"stars": {
"options": [
{
"id": "0",
"label": "0+",
"count": 4687
},
{
"id": "2",
"label": "2",
"count": 125
},
{
"id": "3",
"label": "3",
"count": 481
},
{
"id": "4",
"label": "4",
"count": 357
}
],
"usesStarRatings": true
},
"rating": {
"options": [
{
"id": "awful",
"label": "0+",
"count": 4687
},
{
"id": "okay",
"label": "6+",
"count": 2783
},
{
"id": "good",
"label": "7+",
"count": 2390
},
{
"id": "great",
"label": "8+",
"count": 1704
}
]
},
"freebies": {
"options": [
{
"id": "freeinternet",
"label": "Free internet",
"count": 3464,
"icon": "freeinternet"
},
{
"id": "freecancellation",
"label": "Free cancellation",
"count": 2239,
"icon": "freecancellation"
},
{
"id": "freeparking",
"label": "Free parking",
"count": 1027,
"icon": "freeparking"
},
{
"id": "postpay",
"label": "Pay later",
"count": 179,
"icon": "time"
}
]
},
"propertyType": {
"options": [
{
"id": "apthotel",
"label": "Aparthotel",
"count": 76,
"parent": "hotels"
},
{
"id": "bb",
"label": "Bed & Breakfast",
"count": 35,
"parent": "hotels"
},
{
"id": "guesthouse",
"label": "Guest house",
"count": 176,
"parent": "hotels"
},
{
"id": "hostel",
"label": "Hostel",
"count": 33,
"parent": "hotels"
}
]
},
"amenities": {
"options": [
{
"id": "nosmokerooms",
"label": "Non-smoking rooms",
"count": 4345,
"icon": "smoking-na",
"category": "general"
},
{
"id": "wifi",
"label": "Wi-Fi",
"count": 4116,
"icon": "wifi",
"category": "internet"
},
{
"id": "hairdryer",
"label": "Hairdryer",
"count": 3217,
"category": "general"
},
{
"id": "internet",
"label": "Internet",
"count": 2867,
"icon": "internet",
"category": "internet"
}
]
},
"price": {
"values": [
30,
38,
49,
63
],
"formattedValues": [
"$30",
"$38",
"$49",
"$63"
]
}
}
}
hotels · availableFilters.