Search hotels

POST/hotels/search

This call returns a searchToken. It does not return hotels. A London weekend usually answers in 8–16 seconds while the search settles.

Country and currency

Send country to pick the market. Prices come back in that country’s native currency. GB returns GBP, DE returns EUR, US returns USD. Omit country and the market is the US, so prices are USD.

There is no currency field on this call. Sending one is rejected. You cannot ask for US prices in GBP, or UK prices in USD - the country decides the currency.

Place, dates, guests

Send location, checkin, and checkout. adults defaults to 2 and rooms defaults to 1. Add childAges when children are staying, one age per child.

location is an id, not a name. Look it up with Search locations and send locationId. A stay longer than 30 nights is rejected.

When there is nothing to page

If there are no hotels, the call returns 404 NO_RESULTS and no token. A date further than a year out, or an id that is not a place, is the usual cause.

Why a stay search is not a Booking.com reservation: Booking.com API. The captured London example on this page is the response that post points at.

Prices from one booking site

Send providers to keep only the prices one or more booking sites sell. The "Only Booking.com" example on this page is the same London weekend with providers: ["Booking.com"]. Page 1 came back with 27 hotels, 1,072 in total, and every price was from Booking.com.

The names to send come from the data, not from a fixed list. Run a search without providers, read availableFilters.bookingSites on List results, and send the id of each site you want. Up to 10. Each entry also has count, the number of hotels that site sells in this search.

Booking sites that came back in all 10 cities we tested in November 2026: Booking.com, Expedia, Hotels.com, Priceline, Agoda.com, Trip.com, Super.com, HomeToGo, and Preferred Hotels. Smaller sites such as Homestay.com, Traveluro, Pricetravel, and Prestigia appear in some cities. Coverage changes by place and date, so read availableFilters.bookingSites instead of hard-coding the list. Every airline, booking site, and rental company we have seen is on Providers. Six sites compared on one London weekend, with code: hotel price API.

To compare two sites, send both, for example ["Booking.com", "Expedia"]. bestOption on each hotel is then the cheaper of the two, and Retrieve hotel details lists only those sites, each with its price and booking URL. availableFilters.bookingSites still lists every site in the search, so you can switch sites with a new search.

Parameters

The body of the request.

locationstringRequired

A locationId from Search locations. A name is rejected. A named hotel’s locationId is its city; use hotelId only for reviews.

checkinstringRequired

Check-in date, YYYY-MM-DD. Cannot be in the past. Searches are usually published under a year ahead.

checkoutstringRequired

Check-out date, YYYY-MM-DD. Must be at least one night after check-in, and at most 30 nights later.

adultsinteger

Adults, 1–16. Defaults to 2.

roomsinteger

Rooms, 1–8. Defaults to 1.

childAgesarray of integers

Age of each child, 0–17. At most 8. Omit it, or send [], when there are no children.

minStarsinteger

Keep hotels with at least this many stars. 2 through 5. Unrated properties are left out.

minRatinginteger

Keep hotels with at least this guest score. 6, 7, 8, or 9.

maxPriceinteger

Highest before-tax stay price, as a whole number in the country’s native currency. Minimum is 1.

freeCancellationboolean

True to keep stays that can be cancelled without a fee. Defaults to false.

amenitiesarray of strings

Amenity ids from availableFilters.amenities on a previous results page, for example pool. Up to 10. Letters, digits, _, and -.

providersarray of strings

Keep only prices from these booking sites, for example ["Booking.com"]. Use the id values from availableFilters.bookingSites on a previous results page. Up to 10. Omit it to allow every seller.

sortBystring

How to order the results. Defaults to bestValue.

Possible values

bestValue

Default. Recommended order. `sortOrder` does not change it.

price

By the before-tax stay price. `asc` is cheapest first, `desc` is dearest first.

rating

Highest guest score first. `sortOrder` does not change it.

stars

By star class. `asc` is lowest first, `desc` is highest first.

distance

Nearest to the reference point first. `sortOrder` does not change it.

sortOrderstring

Direction for price and stars. Defaults to asc. Other sorts ignore it.

Possible values

asc

Default. Cheapest price, or fewest stars, first.

desc

Dearest price, or most stars, first.

countrystring

ISO 3166-1 alpha-2 market. Prices come back in that country’s native currency - GB returns GBP, DE returns EUR, US returns USD. There is no separate currency field; sending currency is rejected. Omit country for US. Any other value is rejected.

Possible values59

Returns

A successful response, captured live.

                        {
  "searchToken": "eyJwIjoxLCJzIjoiNjgyMmZiMzMyMzA4NDZjNGFiZWRiM2Q2OTRiM2YyNjgiLCJ2IjoxfQ",
  "expiresIn": 3600
}