Booking Reviews

Extract Booking.com hotel reviews, ratings, stars, and reviewer details from hotel URLs

$0.8 / 1k reviews

Extract Booking.com hotel reviews, ratings, stars, and reviewer details from hotel URLs

Endpoint

POST /api/v1/agents/booking/reviews/run

Parameters

urls · array · required

List · Booking.com hotel URLs to scrape reviews from. One per line.

maxReviewsPerHotel · integer · default: 100

Number · Reviews per hotel. Use 0 for all.

sortBy · string · default: "f_relevance"

Dropdown · Sort order for reviews.

Options: f_relevance, f_recent_desc, f_recent_asc, f_score_desc, f_score_asc

Legend: f_relevance = Most relevant, f_recent_desc = Newest first, f_recent_asc = Oldest first, f_score_desc = Highest scores, f_score_asc = Lowest scores

cutoffDate · date

Date picker · Stop loading older/newer reviews past this date. Only applies when Sort By = Newest first OR Oldest first.

reviewScores · array

Multi-select · Filter to reviews in these score bands. Leave empty for all.

Options: review_adj_superb, review_adj_good, review_adj_average_passable, review_adj_poor

Legend: review_adj_superb = Superb (9+), review_adj_good = Good (7-9), review_adj_average_passable = Passable (5-7), review_adj_poor = Poor (3-5)

Response columns

Field	Display name	Type
hotelUrl	Hotel URL	url
reviewTitle	Review Title	text
liked	Liked	text
disliked	Disliked	text
rating	Rating	rating
reviewer	Reviewer	text
reviewerLocation	Reviewer Location	text
reviewerAvatar	Reviewer Avatar	url
travelerType	Traveler Type	text
nights	Nights	number
room	Room	text
checkIn	Check-In	text
checkOut	Check-Out	text
posted	Posted	text
language	Language	text
helpfulVotes	Helpful Votes	number
hotelRating	Hotel Rating	rating
hotelRatingLabel	Hotel Rating Label	text
hotelReviews	Hotel Reviews	number
topSubscoreCategory	Top Subscore Category	text
topSubscore	Top Subscore	rating
totalCategoryReviews	Total Category Reviews	number
scoreFilter	Score Filter	text
page	Page	number
images	Images	text

Example

curl

curl -X POST https://api.mindcase.co/api/v1/agents/booking/reviews/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      {
        "url": "https://www.booking.com/hotel/us/the-plaza.en-gb.html"
      }
    ],
    "maxReviewsPerHotel": 10
  }
}'

Example response

Response

{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "hotelUrl": "https://www.booking.com/hotel/us/the-plaza.en-gb.html",
      "reviewTitle": "Expereience worth for it",
      "liked": "Great location. Very authentic and elegantly decorated ambiance. Kind and helpful service.",
      "disliked": "A bit expensive but worth for experience",
      "rating": 10,
      "reviewer": "Muhammet",
      "reviewerLocation": "Turkey",
      "reviewerAvatar": "https://xx.bstatic.com/static/img/review/avatars/ava-m.png",
      "travelerType": "Couple",
      "nights": 1,
      "room": "Plaza Room",
      "checkIn": "2026-04-24",
      "checkOut": "2026-04-25",
      "posted": "2026-04-29T15:18:40.000Z",
      "language": "en",
      "helpfulVotes": 0,
      "hotelRating": 8.5,
      "hotelRatingLabel": "Very good",
      "hotelReviews": 556,
      "topSubscoreCategory": null,
      "topSubscore": null,
      "totalCategoryReviews": 556,
      "scoreFilter": "ALL",
      "page": 1,
      "images": []
    }
  ]
}