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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
By Search: a destination or search keyword (city, region, landmark, or area), e.g. “Paris” or “Bali villas”.
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.Filter to a property type (Hotels, Apartments, Villas, Guest houses, Hostels, B&Bs, Resorts, Homestays).
Nightly/total price range for the searched dates, as min and max in the chosen currency (e.g. 150 to 400).
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 indata is one listing, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For review text usebooking/reviews; for prices across booking sites use google-hotels/hotels.