Skip to main content
POST /v1/data/booking/listings/run Pricing: $0.002 per listing ($2.00 per 1,000).

Ways to call it

  • Search: set location (optional: checkIn, checkOut, maxResults, currency, language, propertyType, starsCountFilter, minScore, …)
  • URL: set urls (optional: checkIn, checkOut)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
By Search: a destination or search keyword (city, region, landmark, or area), e.g. “Paris” or “Bali villas”.
date
Check-in date (YYYY-MM-DD). Required for price and room availability; omit it and price/room columns come back empty.Use together with checkout.
date
Check-out date (YYYY-MM-DD). Required alongside check-in for pricing.Use together with checkin.
integer
Maximum number of listings to return. Use 0 for all.
string
Filter to a property type (Hotels, Apartments, Villas, Guest houses, Hostels, B&Bs, Resorts, Homestays).
string
Filter to properties with at least this official star class (1-5).
number
Filter to properties with at least this guest score (0-10, e.g. 8.5).
string
Nightly/total price range for the searched dates, as min and max in the chosen currency (e.g. 150 to 400).
string
Result sort order (defaults to relevance).
string
default:"USD"
Currency for prices (EUR, USD, GBP, JPY, INR, MXN, AUD, CAD, …).
string
default:"en-gb"
Language/locale for the property data.
string[]
By URL: Booking.com hotel URLs or search-page URLs. Add check-in/check-out dates for price and room availability.

Example

Response fields

Each row in data is one listing, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For review text use booking/reviews; for prices across booking sites use google-hotels/hotels.