scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTHotel
  • POSTReviews
  • POSTSearch

Booking.com Hotel

1 credit

Get hotel details from Booking.com.

POST/api/v1/tools/booking/hotel

Parameters

hotelstringrequired

Booking.com hotel URL or numeric hotel ID.

checkInstring

Check-in date in YYYY-MM-DD format. Enables pricing and available rooms. Must be provided together with checkOut.

checkOutstring

Check-out date in YYYY-MM-DD format. Must be provided together with checkIn.

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.

languagestring

Language code. Defaults to "en-us".

fieldsstring[]

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

Response Schema

dataobject

Booking.com hotel result

hotelobject

Hotel details

metaobject

Request metadata

toolstring

Tool name (booking-hotel)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/booking/hotel \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"hotel": "https://www.booking.com/hotel/it/grand-excelsior.html",
"checkIn": "2026-05-01",
"checkOut": "2026-05-03",
"adults": 2
}'

Response Example

{
"data": {
"hotel": {
"hotelId": 25924,
"name": "Grand Hotel Excelsior",
"url": "https://www.booking.com/hotel/it/grand-excelsior.html",
"address": "Via Veneto 125",
"city": "Rome",
"countryCode": "IT",
"starRating": {
"value": 5,
"symbol": "stars"
},
"reviewScore": 8.9,
"reviewsCount": 2341,
"description": "Located on Via Veneto, this 5-star hotel features a rooftop terrace..."
}
},
"meta": {
"tool": "booking-hotel",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}