https://api.sandbase.ai/v1/api/booking/searchSearch Booking.com properties by destination and dates, with property name, price, rating, review score, address and photos.
Your output will appear here
Complete the inputs, then click Run.
Search Booking.com properties by destination and dates, with property name, price, rating, review score, address and photos.
curl -X POST "https://api.sandbase.ai/v1/api/booking/search" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "Austin"}'
The result is returned in outputs[0].data as structured JSON.
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Parameter defines the destination to search for: a city, a region, a district, a landmark, or an airport (e.g., Paris, Tuscany, Manhattan, or Eiffel Tower). Booking.com doesn't return results for most street addresses. |
hl | string | No | Parameter defines the language to use for the Booking.com search (e.g., en-us (default) for English (US), fr for French, or pt-br for Portuguese (Brazil)). Head to the Booking.com languages page for a full list of supported languages. |
currency | string | No | Parameter defines the currency of the returned prices. It defaults to hotel_currency, the currency of each property (e.g., EUR in Paris), returned in currency of each property. Head to the Booking.com currencies page for a full list o |
check_in_date | string | No | Parameter defines the check-in date. The format is YYYY-MM-DD (e.g., 2026-12-12). It must be used together with check_out_date. When dates aren't set, Booking.com returns properties without prices. |
check_out_date | string | No | Parameter defines the check-out date. The format is YYYY-MM-DD (e.g., 2026-12-15). It must be used together with check_in_date, and be up to 90 nights later than it. |
flex_window | string | No | Parameter defines how many days the check-in and check-out dates can move, earlier or later, for the best price of each property. Each property then has the dates of its price in check_in_date and check_out_date. It must be used togethe |
adults | string | No | Parameter defines the number of adults, from 1 to 30. It defaults to 2. |
children | string | No | Parameter defines the number of children, from 0 (default) to 10. Their ages must be set with children_ages. |
children_ages | string | No | Parameter defines the age of each child at check-out, from 0 to 17. It's a comma-separated list of ages (e.g., 5 for one child, or 5,9 for two children). When children isn't set, it's the number of ages. |
rooms | string | No | Parameter defines the number of rooms, from 1 (default) to 30. It can't be greater than the number of adults. |
sort_by | string | No | Parameter defines the sorting of the results. It defaults to popularity (Our top picks). Available options: popularity - Our top picks upsort_bh - Homes & apartments first price - Price (lowest first) price_from_high_to_low - Pric |
min_price | string | No | Parameter defines the minimum price per night, in the currency of the results (e.g., 100). It must be used together with a currency code. |
max_price | string | No | Parameter defines the maximum price per night, in the currency of the results (e.g., 300). It must be used together with a currency code. |
hotel_class | string | No | Parameter defines the property ratings to show: stars for hotels, or Booking.com's own rating for homes and apartments. It's a comma-separated list of ratings from 1 to 5 (e.g., 4,5 for 4 and 5-star properties). |
rating | string | No | Parameter defines the minimum review score of the properties. Available options: 9 - Wonderful: 9+ 8 - Very Good: 8+ 7 - Good: 7+ 6 - Pleasant: 6+ |
free_cancellation | string | No | Parameter defines whether to only show properties with free cancellation. It can be set to true or false (default). |
property_types | string | No | Parameter defines the property types to show. It's a comma-separated list of property type IDs (e.g., 204 for hotels, or 201,220 for apartments and vacation homes). Head to the Booking.com property types page for a full list of supporte |
nflt | string | No | Parameter defines any other Booking.com filters, like amenities, meals, districts, brands, or distance from the center. It's the value of the nflt parameter of Booking.com search URLs: a semicolon-separated list of filters (e.g., `hotelfa |
offset | string | No | Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 25 is the 2nd page of results with the default limit, etc.). It can be up to 1000: |
limit | string | No | Parameter defines the maximum number of results to return, from 1 to 100. It defaults to 25, like on Booking.com. Booking.com sometimes returns a few more properties: sponsored ones, or the searched property. |
session_token | string | No | Parameter defines the token that keeps the same Booking.com visitor between searches. Booking.com ranks properties differently for each visitor, so without it, the next pages can repeat properties of the previous ones. It's returned in `the |
device | string | No | Parameter defines the device to use to get the results. It can be set to desktop (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or mobile to use a mobile browser. |
json_restrictor | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |
$0.010 per successful call. Failed calls are not charged.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/booking/search" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"q": "Austin"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
qstringrequiredParameter defines the destination to search for: a city, a region, a district, a landmark, or an airport (e.g., `Paris`, `Tuscany`, `Manhattan`, or `Eiffel Tower`). Booking.com doesn't return results for most street addresses.
hlstringParameter defines the language to use for the Booking.com search (e.g., `en-us` (default) for English (US), `fr` for French, or `pt-br` for Portuguese (Brazil)). Head to the Booking.com languages page for a full list of supported languages.
currencystringParameter defines the currency of the returned prices. It defaults to `hotel_currency`, the currency of each property (e.g., `EUR` in Paris), returned in `currency` of each property. Head to the Booking.com currencies page for a full list of supported currency codes.
check_in_datestringParameter defines the check-in date. The format is **YYYY-MM-DD** (e.g., `2026-12-12`). It must be used together with `check_out_date`. When dates aren't set, Booking.com returns properties without prices.
check_out_datestringParameter defines the check-out date. The format is **YYYY-MM-DD** (e.g., `2026-12-15`). It must be used together with `check_in_date`, and be up to 90 nights later than it.
flex_windowstringParameter defines how many days the check-in and check-out dates can move, earlier or later, for the best price of each property. Each property then has the dates of its price in `check_in_date` and `check_out_date`. It must be used together with `check_in_date` and `check_out_date`. Available options: `1` - ± 1 day `2` - ± 2 days `3` - ± 3 days `7` - ± 7 days
adultsstringParameter defines the number of adults, from `1` to `30`. It defaults to `2`.
childrenstringParameter defines the number of children, from `0` (default) to `10`. Their ages must be set with `children_ages`.
children_agesstringParameter defines the age of each child at check-out, from `0` to `17`. It's a comma-separated list of ages (e.g., `5` for one child, or `5,9` for two children). When `children` isn't set, it's the number of ages.
roomsstringParameter defines the number of rooms, from `1` (default) to `30`. It can't be greater than the number of `adults`.
sort_bystringParameter defines the sorting of the results. It defaults to `popularity` (Our top picks). Available options: `popularity` - Our top picks `upsort_bh` - Homes & apartments first `price` - Price (lowest first) `price_from_high_to_low` - Price (highest first) `review_score_and_price` - Best reviewed & lowest price `bayesian_review_score` - Top reviewed `class` - Property rating (high to low) `class_asc` - Property rating (low to high) `class_and_price` - Property rating and price `distance_from_search` - Distance from downtown `closest_beach_distance_v2` - Distance from closest beach `closest_sk
min_pricestringParameter defines the minimum price per night, in the currency of the results (e.g., `100`). It must be used together with a `currency` code.
max_pricestringParameter defines the maximum price per night, in the currency of the results (e.g., `300`). It must be used together with a `currency` code.
hotel_classstringParameter defines the property ratings to show: stars for hotels, or Booking.com's own rating for homes and apartments. It's a comma-separated list of ratings from `1` to `5` (e.g., `4,5` for 4 and 5-star properties).
ratingstringParameter defines the minimum review score of the properties. Available options: `9` - Wonderful: 9+ `8` - Very Good: 8+ `7` - Good: 7+ `6` - Pleasant: 6+
free_cancellationstringParameter defines whether to only show properties with free cancellation. It can be set to `true` or `false` (default).
property_typesstringParameter defines the property types to show. It's a comma-separated list of property type IDs (e.g., `204` for hotels, or `201,220` for apartments and vacation homes). Head to the Booking.com property types page for a full list of supported property types.
nfltstringParameter defines any other Booking.com filters, like amenities, meals, districts, brands, or distance from the center. It's the value of the `nflt` parameter of Booking.com search URLs: a semicolon-separated list of filters (e.g., `hotelfacility=107;mealplan=1;di=2286`). The filters available for a search, with their values, are in `filters` of the results.
offsetstringParameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., `0` (default) is the first page of results, `25` is the 2nd page of results with the default `limit`, etc.). It can be up to `1000`: Booking.com returns the same properties for larger offsets, even when it finds more properties.
limitstringParameter defines the maximum number of results to return, from `1` to `100`. It defaults to `25`, like on Booking.com. Booking.com sometimes returns a few more properties: sponsored ones, or the searched property.
session_tokenstringParameter defines the token that keeps the same Booking.com visitor between searches. Booking.com ranks properties differently for each visitor, so without it, the next pages can repeat properties of the previous ones. It's returned in `the API_pagination.session_token`, and the links of `the API_pagination` already include it.
devicestringParameter defines the device to use to get the results. It can be set to `desktop` (default) to use a regular browser, `tablet` to use a tablet browser (currently using iPads), or `mobile` to use a mobile browser.
json_restrictorstringParameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
| API | Price | Response |
|---|---|---|
Booking.com SearchThis API Booking.com | $0.01 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/booking/search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: q (string). Optional: hl (string), currency (string), check_in_date (string), check_out_date (string), flex_window (string) and adults (string) and 16 more. The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous).
No. Booking.com Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Booking.com API access separately.