Booking.com Reviews API Documentation
The Booking.com Reviews API returns the guest reviews of a property, 10 per page: each review's score, title, what the guest liked and disliked, language, date, traveler type,
the guest's name and country, the room and stay dates, photos and the property's reply. It also returns the property's overall rating and category scores, and the filters
available for the property with their counts. Source the url from a Booking.com API result. The
Booking.com Property API returns the same property's details and rooms.
API Parameters
Property
-
- Name
-
url - Required
- Required
- Description
-
The Booking.com property page URL (e.g.
https://www.booking.com/hotel/hr/city-dubrovnik.html). Obtain it from theproperties[].linkfield of a Booking.com API response.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
The page of reviews, 10 per page. Defaults to
1.pagination.next_pageis the value for the next page. A page past the last one returns an error.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
The order of the reviews:
most_relevant(default),newest,oldest,highest_scoreorlowest_score.
Filters
-
- Name
-
languages - Required
- Optional
- Description
-
Comma-separated language codes of the reviews to return, such as
enoren,de.filters.languageslists the codes this property has, with their counts.
-
- Name
-
traveler_type - Required
- Optional
- Description
-
Only reviews from
families,couples,groups_of_friends,solo_travelersorbusiness_travelers.business_travelersselects business trips, so those reviews can show anothertravel_type.
-
- Name
-
score - Required
- Optional
- Description
-
Only reviews in a score band:
wonderful(9+),good(7–9),decent(5–7),poor(3–5) orvery_poor(1–3).
-
- Name
-
time_of_year - Required
- Optional
- Description
-
Only reviews written in
mar_may,jun_aug,sep_novordec_feb.
-
- Name
-
topic_id - Required
- Optional
- Description
-
Only reviews that mention a topic, such as breakfast or location. Take the id from
filters.topics.
-
- Name
-
q - Required
- Optional
- Description
-
Only reviews containing this text.
Localization
-
- Name
-
language - Required
- Optional
- Description
-
The Booking.com locale for category, filter and traveler names (e.g.
en-us,de,fr). Defaults toen-us. Reviews keep the language they were written in.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
booking_reviews.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Guest Reviews
https://www.searchapi.io/api/v1/search?engine=booking_reviews&url=https%3A%2F%2Fwww.booking.com%2Fhotel%2Fhr%2Fcity-dubrovnik.html
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "booking_reviews",
"url": "https://www.booking.com/hotel/hr/city-dubrovnik.html"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Y80BKjxagxvjcxEy35nMQeWO",
"status": "Success",
"created_at": "2026-11-09T21:18:48Z",
"request_time_taken": 1.5,
"parsing_time_taken": 0.03,
"total_time_taken": 1.53,
"request_url": "https://www.booking.com/hotel/hr/city-dubrovnik.html",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Y80BKjxagxvjcxEy35nMQeWO.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Y80BKjxagxvjcxEy35nMQeWO"
},
"search_parameters": {
"engine": "booking_reviews",
"url": "https://www.booking.com/hotel/hr/city-dubrovnik.html"
},
"search_information": {
"total_results": 1868
},
"place_result": {
"name": "City Hotel Dubrovnik",
"link": "https://www.booking.com/hotel/hr/city-dubrovnik.html",
"address": "4 Hrvatskog Crvenog Kriza",
"city": "Dubrovnik",
"country_code": "hr",
"rating": 8.9,
"reviews_count": 1869,
"category_scores": [
{
"key": "location",
"name": "Location",
"score": 8.84,
"reviews_count": 1828,
"area_low": 8.58,
"area_high": 9.84
},
{
"key": "clean",
"name": "Cleanliness",
"score": 9.33,
"reviews_count": 1833,
"area_low": 8.62,
"area_high": 9.97
},
{
"key": "value",
"name": "Value for money",
"score": 8.46,
"reviews_count": 1833,
"area_low": 8.29,
"area_high": 9.6
}
]
},
"reviews": [
{
"position": 1,
"review_id": "21e09c5bbce2f80c",
"title": "Overall pretty good.",
"liked": "Great location, big rooms, friendly receptionist, plenty of storage, good selection for buffet breakfast, good value for money, comfortable beds, very nice hot showers. Adequate space for reserved parking. Bus stops with frequent service to old town.",
"disliked": "Overall nothing; minor improvement with buffet breakfast is the hot water for tea was lukewarm and could do with being hot.",
"rating": 9.0,
"language": "en",
"date": "2024-10-23T21:50:45Z",
"helpful_votes": 0,
"travel_type": "Group",
"author": {
"name": "Geetha",
"country": "United Kingdom",
"country_code": "gb",
"avatar": "https://xx.bstatic.com/static/img/review/avatars/ava-g.png",
"is_anonymous": false
},
"stay": {
"room_type": "Standard Double or Twin Room",
"nights": 1,
"check_in_date": "2024-10-22",
"check_out_date": "2024-10-23"
},
"reply": "Dear Geetha, Thank you for taking time to share your experience in City Hotel. We are expecting to welcome you back to our hotel. Kind regards, City Hotel Team"
},
{
"position": 2,
"review_id": "5b5e1857850e320e",
"title": "Overall, a very positive rating for this hotel during our stay.",
"liked": "Breakfast was very good.",
"disliked": "One morning there were too many tourists and there was no food left at the breakfast buffet at 8 am. We had to wait a few minutes for the staff to provide breakfast for us.",
"rating": 9.0,
"language": "en-us",
"date": "2024-06-05T13:51:50Z",
"helpful_votes": 0,
"travel_type": "Couple",
"author": {
"name": "Dorothy",
"country": "United States",
"country_code": "us",
"is_anonymous": false
},
"stay": {
"room_type": "Deluxe Double or Twin Room with Terrace and Sea View",
"nights": 1,
"check_in_date": "2024-05-08",
"check_out_date": "2024-05-09"
},
"reply": "Dear Dorothy, Thank you for the kind words. We would like to apologize for the inconvenience you experienced. Thank you for your review, we have learned from it. Our warmest regards, City hotel team"
},
{
"position": 3,
"review_id": "971fb60570f7f09f",
"title": "Excellent hotel in Dubrovnik",
"liked": "Excellent hotel with new facilities and big rooms. It is located outside the walls of the old city nearby the harbour. The old city is 20 minutes walk where you can enjoy the stunning view to the Adriatic Sea. Friendly staff. Breakfast excellent but we had to order it every day in the restaurant and pay extra. Fully recommended. Overall 9/10 (only because the breakfast was extra).",
"disliked": "The only issue is that the breakfast was not included in the price of the room. We had to pay extra every day. You should include the breakfast as an option in the room price.",
"rating": 9.0,
"language": "en",
"date": "2024-05-13T09:07:25Z",
"helpful_votes": 0,
"travel_type": "Couple",
"author": {
"name": "Konstantinos",
"country": "Greece",
"country_code": "gr",
"avatar": "https://lh3.googleusercontent.com/a/AATXAJyKsCjwbVW9lcuGPwqQ5AInenFzbAa3S24oXF3R=s96-c",
"is_anonymous": false
},
"stay": {
"room_type": "Standard Double or Twin Room",
"nights": 3,
"check_in_date": "2024-05-03",
"check_out_date": "2024-05-06"
},
"reply": "Dear KONSTANTINOS, We are glad to see your satisfaction with the service provided, and would like to apologize for the inconvenience you experienced with the breakfast. Thank you for your review, we have learned from it. Our warmest regards, City hotel team"
}
],
"filters": {
"languages": [
{
"value": "en",
"name": "English",
"count": 863
},
{
"value": "es",
"name": "Spanish",
"count": 103
},
{
"value": "zh",
"name": "Chinese",
"count": 18
}
],
"traveler_types": [
{
"value": "families",
"name": "Families",
"count": 517
},
{
"value": "couples",
"name": "Couples",
"count": 608
},
{
"value": "groups_of_friends",
"name": "Groups of friends",
"count": 237
}
],
"scores": [
{
"value": "wonderful",
"name": "Wonderful: 9+",
"count": 1315
},
{
"value": "good",
"name": "Good: 7–9",
"count": 468
},
{
"value": "decent",
"name": "Decent: 5–7",
"count": 60
}
],
"times_of_year": [
{
"value": "mar_may",
"name": "Mar–May",
"count": 0
},
{
"value": "jun_aug",
"name": "Jun–Aug",
"count": 0
},
{
"value": "sep_nov",
"name": "Sep–Nov",
"count": 0
}
],
"topics": [
{
"topic_id": 270,
"name": "Room"
},
{
"topic_id": 249,
"name": "Location"
},
{
"topic_id": 276,
"name": "Clean"
}
]
},
"pagination": {
"current": 1,
"next_page": 2,
"total_pages": 187
}
}
Newest Reviews from Couples in English
https://www.searchapi.io/api/v1/search?engine=booking_reviews&languages=en&sort_by=newest&traveler_type=couples&url=https%3A%2F%2Fwww.booking.com%2Fhotel%2Fhr%2Fcity-dubrovnik.html
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "booking_reviews",
"url": "https://www.booking.com/hotel/hr/city-dubrovnik.html",
"traveler_type": "couples",
"sort_by": "newest",
"languages": "en"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_xRvzEGkNolVqF60Opj4Q9WJb",
"status": "Success",
"created_at": "2026-11-09T21:18:51Z",
"request_time_taken": 1.64,
"parsing_time_taken": 0.01,
"total_time_taken": 1.65,
"request_url": "https://www.booking.com/hotel/hr/city-dubrovnik.html",
"html_url": "https://www.searchapi.io/api/v1/searches/search_xRvzEGkNolVqF60Opj4Q9WJb.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_xRvzEGkNolVqF60Opj4Q9WJb"
},
"search_parameters": {
"engine": "booking_reviews",
"url": "https://www.booking.com/hotel/hr/city-dubrovnik.html",
"sort_by": "newest",
"languages": "en",
"traveler_type": "couples"
},
"search_information": {
"total_results": 302
},
"place_result": {
"name": "City Hotel Dubrovnik",
"link": "https://www.booking.com/hotel/hr/city-dubrovnik.html",
"address": "4 Hrvatskog Crvenog Kriza",
"city": "Dubrovnik",
"country_code": "hr",
"rating": 8.9,
"reviews_count": 1869,
"category_scores": [
{
"key": "clean",
"name": "Cleanliness",
"score": 9.33,
"reviews_count": 1833,
"area_low": 8.62,
"area_high": 9.97
},
{
"key": "comfort",
"name": "Comfort",
"score": 9.28,
"reviews_count": 1832,
"area_low": 8.6,
"area_high": 9.95
},
{
"key": "services",
"name": "Facilities",
"score": 8.91,
"reviews_count": 1830,
"area_low": 8.31,
"area_high": 9.85
}
]
},
"reviews": [
{
"position": 1,
"review_id": "202cf2e92ce5e2ac",
"title": "Great option for your Dubrovnik stay.",
"liked": "Spacious modern room. Very comfortable. Surprised us with a welcome selection of handmade chocolates. Very nice touch. We were boarding a small ship cruise the next day so a perfect option.",
"disliked": "I knew it was a bit far from Old Town but there is a bus right outside.",
"rating": 10.0,
"language": "en-us",
"date": "2026-10-29T20:01:57Z",
"helpful_votes": 0,
"travel_type": "Couple",
"author": {
"name": "Linda",
"country": "United States",
"country_code": "us",
"avatar": "https://xx.bstatic.com/static/img/review/avatars/ava-l.png",
"is_anonymous": false
},
"stay": {
"room_type": "Junior Suite",
"nights": 1,
"check_in_date": "2026-10-02",
"check_out_date": "2026-10-03"
},
"reply": "Dear Linda,\n\nThank you very much for your lovely review! We are delighted to hear that you enjoyed our spacious and modern rooms, the comfort of your stay, and the handmade chocolates prepared as a welcome treat. We are also pleased that our location and convenient bus connection made your stay comfortable and suited your travel plans.\n\nIt was a pleasure having you with us, and we hope to welcome you back again in the future!\n\nKind regards, \nCity Hotel Dubrovnik"
},
{
"position": 2,
"review_id": "7e6fcfbecb5e08fb",
"rating": 9.0,
"language": "en-us",
"date": "2026-10-19T19:43:06Z",
"travel_type": "Couple",
"author": {
"name": "Alexander",
"country": "United States",
"country_code": "us",
"avatar": "https://graph.facebook.com/v2.9/1769656409720205/picture?type=square&height=64&width=64",
"is_anonymous": false
},
"stay": {
"room_type": "Superior Double or Twin Room with Balcony",
"nights": 2,
"check_in_date": "2026-09-28",
"check_out_date": "2026-09-30"
}
},
{
"position": 3,
"review_id": "e14131b07749a5d4",
"rating": 9.0,
"language": "en-us",
"date": "2026-10-15T16:38:42Z",
"travel_type": "Couple",
"author": {
"name": "Shaker",
"country": "United States",
"country_code": "us",
"is_anonymous": false
},
"stay": {
"room_type": "Standard Double or Twin Room",
"nights": 2,
"check_in_date": "2026-09-16",
"check_out_date": "2026-09-18"
}
}
],
"filters": {
"languages": [
{
"value": "en",
"name": "English",
"count": 863
},
{
"value": "es",
"name": "Spanish",
"count": 103
},
{
"value": "zh",
"name": "Chinese",
"count": 18
}
],
"traveler_types": [
{
"value": "families",
"name": "Families",
"count": 517
},
{
"value": "couples",
"name": "Couples",
"count": 608
},
{
"value": "groups_of_friends",
"name": "Groups of friends",
"count": 237
}
],
"scores": [
{
"value": "wonderful",
"name": "Wonderful: 9+",
"count": 1315
},
{
"value": "good",
"name": "Good: 7–9",
"count": 468
},
{
"value": "decent",
"name": "Decent: 5–7",
"count": 60
}
],
"times_of_year": [
{
"value": "mar_may",
"name": "Mar–May",
"count": 0
},
{
"value": "jun_aug",
"name": "Jun–Aug",
"count": 0
},
{
"value": "sep_nov",
"name": "Sep–Nov",
"count": 0
}
],
"topics": [
{
"topic_id": 270,
"name": "Room"
},
{
"topic_id": 249,
"name": "Location"
},
{
"topic_id": 267,
"name": "Bus"
}
]
},
"pagination": {
"current": 1,
"next_page": 2,
"total_pages": 31
}
}