scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTHotel
  • POSTReviews
  • POSTSearch

Booking.com Search

1 credit

Search hotels on Booking.com.

POST/api/v1/tools/booking/search

Parameters

searchstringrequired

Destination name (city, region, country).

checkInstringrequired

Check-in date in YYYY-MM-DD format.

checkOutstringrequired

Check-out date in YYYY-MM-DD format.

adultsnumber

Number of adults (min 1). Defaults to 2.

childrennumber

Number of children. Defaults to 0.

childrenAgesnumber[]

Ages of children (0-17 each).

roomsnumber

Number of rooms (min 1). Defaults to 1.

maxResultsnumber

Maximum results. Defaults to 20.

languagestring

Language code. Defaults to "en-us".

sortBystring

Sort order. One of "relevance", "rating_highest", "rating_lowest", "newest_first", "oldest_first". Defaults to "relevance".

filterStarRatingnumber[]

Filter by star rating. Array of integers 1-5, e.g. [4, 5].

filterPriceobject

Filter by price range. Object with min (number), max (number), and currency (string).

filterReviewScorestring

Minimum review score. One of "5+", "6+", "7+", "8+", "9+".

filterPropertyTypestring[]

Property type IDs. Examples: "204" (Hotels), "201" (Apartments), "220" (Vacation Homes), "216" (Guesthouses).

filterNeighborhoodstring[]

Neighborhood IDs to filter by.

filterMealsstring[]

Meal plan filters. Examples: "breakfast_included", "all_inclusive".

filterFacilitiesstring[]

Facility filters. Examples: "Free WiFi", "Parking", "Swimming pool".

filterRoomFacilitiesstring[]

Room facility filters. Examples: "Balcony", "Washing machine".

filterBedPreferencestring[]

Bed preference type filters.

filterBrandsstring[]

Hotel chain or brand ID filters.

filterFreeCancellationboolean

Only show properties with free cancellation.

filterDistanceFromCenterstring

Maximum distance from city center. One of "1km", "3km", "5km".

filterSustainabilityboolean

Only show sustainable properties.

filterNumberOfBedroomsnumber

Minimum number of bedrooms (min 1).

filterNumberOfBedsnumber

Minimum number of beds (min 1).

filterTravelPurposestring

Travel purpose. One of "business", "leisure".

fieldsstring[]

Fields to include. Omit or pass ["*"] for all.

Response Schema

dataobject

Booking.com search result

resultsobject[]

Array of hotel search results

countnumber

Number of results returned

truncatedboolean

True if results were cut short due to a timeout or server limit. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (booking-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/booking/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "search": "Rome",
    "checkIn": "2026-05-01",
    "checkOut": "2026-05-03",
    "adults": 2,
    "sortBy": "rating_highest"
  }'

Response Example

{
  "data": {
    "results": [
      {
        "hotelId": 25924,
        "name": "Grand Hotel Excelsior",
        "url": "https://www.booking.com/hotel/it/grand-excelsior.html",
        "address": "Via Veneto 125, Rome",
        "starRating": 5,
        "reviewScore": 8.9,
        "reviewsCount": 2341,
        "accommodationType": "Hotel",
        "pricing": {
          "displayPrice": "$289",
          "currency": "USD",
          "averagePricePerNight": "$289",
          "showFreeCancellation": true
        }
      }
    ],
    "count": 1,
    "truncated": false
  },
  "meta": {
    "tool": "booking-search",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}