scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTHotel
  • POSTReviews
  • POSTSearch

Booking.com Reviews

1 credit

Get guest reviews for a hotel from Booking.com.

POST/api/v1/tools/booking/reviews

Parameters

hotelstringrequired

Booking.com hotel URL or numeric hotel ID.

maxReviewsnumber

Maximum reviews to fetch. Defaults to 20.

languagestring

Language code. Defaults to "en-us".

fieldsstring[]

Fields to include. Omit or pass ["*"] for all. Default fields: score, title, positiveText, negativeText, date, guestName, guestCountry.

Response Schema

dataobject

Booking.com reviews result

reviewsobject[]

Array of review objects. Fields depend on the fields parameter. Default fields: score, title, positiveText, negativeText, date, guestName, guestCountry.

countnumber

Number of reviews 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-reviews)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/booking/reviews \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"hotel": "https://www.booking.com/hotel/it/grand-excelsior.html",
"maxReviews": 10,
"language": "en-us"
}'

Response Example

{
"data": {
"reviews": [
{
"score": 9.2,
"title": "Amazing location and service",
"positiveText": "The staff was incredibly helpful and the breakfast buffet was outstanding.",
"negativeText": "The Wi-Fi could be faster.",
"date": 1712534400,
"guestName": "Maria S.",
"guestCountry": "DE"
}
],
"count": 1,
"truncated": false
},
"meta": {
"tool": "booking-reviews",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}