Booking.com Reviews API Documentation

GET   /api/v1/search?engine=booking_reviews

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 the properties[].link field of a Booking.com API response.

Pagination

  • Name
    page
    Required
    Optional
    Description

    The page of reviews, 10 per page. Defaults to 1. pagination.next_page is 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_score or lowest_score.

Filters

  • Name
    languages
    Required
    Optional
    Description

    Comma-separated language codes of the reviews to return, such as en or en,de. filters.languages lists the codes this property has, with their counts.

  • Name
    traveler_type
    Required
    Optional
    Description

    Only reviews from families, couples, groups_of_friends, solo_travelers or business_travelers. business_travelers selects business trips, so those reviews can show another travel_type.

  • Name
    score
    Required
    Optional
    Description

    Only reviews in a score band: wonderful (9+), good (7–9), decent (5–7), poor (3–5) or very_poor (1–3).

  • Name
    time_of_year
    Required
    Optional
    Description

    Only reviews written in mar_may, jun_aug, sep_nov or dec_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 to en-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_key authenticates 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 true to 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

Guest Reviews
GET
https://www.searchapi.io/api/v1/search?engine=booking_reviews&url=https%3A%2F%2Fwww.booking.com%2Fhotel%2Fhr%2Fcity-dubrovnik.html
Request
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)
Response
{
  "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

Newest Reviews from Couples in English
GET
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
Request
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)
Response
{
  "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
  }
}