Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt

Use this file to discover all available pages before exploring further.

The Booking Search API returns the collection of accommodations from a Booking.com search results page for a given destination and stay dates, with rich filtering by property type, rating, facilities, price and more.

​
Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

​
Request Cost and API Credits

Each request to the Booking Search API consumes API Credits from your account balance.
  • Cost per request: 10 API Credits
  • Credits are deducted only for successful requests.
  • Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
Unused credits do not roll over. Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at app.hasdata.com.

​
Make Your First Request

curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/booking/search' \
  --data-urlencode 'keyword=Paris' \
  --data-urlencode 'checkInDate=2026-06-01' \
  --data-urlencode 'checkOutDate=2026-06-05' \
  --data-urlencode 'rooms=1' \
  --data-urlencode 'adults=2' \
  --data-urlencode 'children[number]=0' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

​
API Parameters

ParameterDefault ValueRequiredDescription
keywordParisYesFree-text destination query. Usually a city, region or neighborhood (e.g. Paris, Manhattan, New York); a specific property name is also accepted.
sort-NoSort order applied by Booking.com to the results page.
checkInDate2026-06-01YesCheck-in date in YYYY-MM-DD format. Must be in the future and earlier than checkOutDate.
checkOutDate2026-06-05YesCheck-out date in YYYY-MM-DD format. Must be later than checkInDate.
rooms1YesNumber of rooms to book.
adults2YesNumber of adult guests across all rooms.
children[number]-YesNumber of child guests across all rooms (0–10). Pass 0 if there are no children.
children[ages][]-NoAges of the children, one entry per child. Required when children[number] > 0 and the array length must equal children[number]. Must not be passed when children[number] = 0.
price[min]-NoMinimum total price for the stay, in the requested currency. Must be >= 10. Required if price[max] is omitted.
price[max]-NoMaximum total price for the stay, in the requested currency. Must be >= 20 and greater than price[min]. Required if price[min] is omitted.
bedrooms-NoMinimum number of bedrooms in the property.
bathrooms-NoMinimum number of bathrooms in the property.
propertyType[]-NoFilter by property type. Multiple values are combined with OR.
rating[]-NoFilter by official star rating. Multiple values are combined with OR.
reviewScore[]-NoFilter by minimum guest review score bucket. Multiple values are combined with OR.
distanceFromCenter[]-NoFilter by distance from the destination center. Multiple values are combined with OR.
propertyAccessibility[]-NoFilter by property-level accessibility features. Multiple values are combined with OR.
meals[]-NoFilter by available meal plans. Multiple values are combined with OR.
facilities[]-NoFilter by property-level facilities. Multiple values are combined with OR.
roomFacilities[]-NoFilter by in-room facilities. Multiple values are combined with OR.
roomAccessibility[]-NoFilter by in-room accessibility features. Multiple values are combined with OR.
bedPreference[]-NoFilter by bed configuration. Multiple values are combined with OR.
reservationPolicy[]-NoFilter by reservation flexibility. Multiple values are combined with OR.
onlinePayment[]-NoFilter by online payment options.
travelGroup[]-NoFilter by travel-group oriented stay options. Multiple values are combined with OR.
language-NoLanguage of the Booking.com interface and localized fields in the response.
currency-NoCurrency of the prices returned in the response. Use hotelCurrency to keep each property’s native currency.
page-NoPage number of the search results. Booking.com returns 25 results per page; pass 2 for results 26–50, 3 for 51–75, etc.