Guest and Host Reviews

Retrieve Guest and Host Reviews

The reviews API makes it easy to retrieve the published guest review of a listing and the published host review of the guest per reservation for bookings made via Airbnb or Booking.com. The reviews will include:

  • Guest name
  • Listing ID
  • Reservation ID / Confirmation code
  • The review content

📘

Tip

Once the booking channel releases the reviews for public consumption, you have the opportunity to further promote your business by publishing them to your website.

Please refer to the API Explorer for more information.

Endpoint

MethodEndpoint
GET/api/reviews

Airbnb Review Object

This table delineates the fields that constitute the Airbnb review data supplied by the Booking Engine.

rawReviewObject containing the review data.Object
-- idThe internal Guesty ID of the review.String
-- reviewer_roleDefines the reviewer. E.g. "guest".String
-- reviewer_idThe Airbnb guest ID.Integer
-- reviewee_roleDefines the recipient of the review. E.g. "host".String
-- reviewee_idThe Airbnb host ID.Integer
-- listing_idThe Airbnb listing ID.Integer
-- reservation_confirmation_codeThe Airbnb reservation confirmation code. E.g. "HMTZ9DWB9W".String
-- hiddenWhether the review remains hidden from public view.Boolean
-- submittedWhether the review has been submitted for publishing.Boolean
-- overall ratingThe guest's overall rating of their stay.Integer / Float
-- public_reviewThe content of the review.String
-- id_str-String
-- reviewer_id_strAirbnb guest ID.String
-- reviewee_id_strAirbnb host ID.String
-- listing_id_strAirbnb listing ID.String
-- expires_atE.g. "2022-07-15T06:15:05.198Z".String
-- first_completed_atDate and time the review was written. E.g. '"2022-07-14T11:44:02.563Z"`.String
-- submitted_atDate and time the review was submitted. E.g. "2022-07-14T11:44:55.556Z".String
-- category_ratings_accuracyMeasures the accuracy of the Airbnb advertisement.Integer / Float
-- category_ratings_communicationRate the host's responsiveness to the guest's messages.Integer / Float
-- category_ratings_valueMeasures the guest's perceived value in relation to the cost of the stay.Integer / Float
-- category_ratings_locationRates whether adequate information concerning the location of the property was supplied by the host.Integer / Float
-- category_ratings_checkinRates the ease of the check-in process for the property.Integer / Float
-- category_ratings_cleanlinessRates the cleanliness of the property.Integer / Float

For more information on Airbnb's start ratings, refer to their Help Center.

Booking.com Review Object

This table delineates the fields that constitute the Booking.com review data supplied by the Booking Engine.

Body ParameterDetailsData Type
rawReviewObject containing the review data.Object
-- listingIdThe Guesty ID of the listing that hosted the reservation.String
-- last_change_timestampE.g. "2022-07-14 12:31:12"String
-- reservation_idExternal reservation ID.Integer
-- contentContains the content of the review.Object
---- positiveGuest review of the positive aspects of their stay.String
---- negativeGuest review of the negative aspects of their stay.String
---- headlineGuest's short review description.String
---- language_codeThe language the review is written in. E.g. "en-gb"String
-- review_idExternal review IDString
-- urlThe source of the review imported into Guesty.String
-- reviewerSummary information on the reviewer (guest).Object
---- is_geniusIndicated whether the reviewer is a member of Airbnb's Genius program.Boolean
---- country_codeLocation of the reviewer. E.g. "gb".String
---- nameName of the reviewer.String
-- reply-String
-- created_timestampThe date and time the review was published. E.g. "2022-07-14 12:00:38".String
-- scoringContains the ratings for the different aspects of the property.Object
---- staffRates the service the guest received from the host.Float / Integer
---- comfortRates the level of comfort the guest experienced at the property.Float / Integer
---- review_scoreThe overall aggregated rating of the property by the guest.Float / Integer
---- valueRates the value the guest felt they received.Float / Integer
---- cleanRate the cleanliness of the property.Float / Integer
---- facilitiesRates the facilities provided.Float / Integer

For more information on Booking.com's review system, click here.

Retrieving All Reviews

This GET request retrieves all reviews, depending on the filters specified.

Query Parameters

ParameterDetailsData Type
channelIdOne of two booking channels: airbnb2 or bookingCom.String
startDateDefines the start of a date range (YYYY-MM-DD).String
endDateDefines the end of a date range (YYYY-MM-DD).String
skipThe number of items to skip over before returning a result.Integer
limitThe number of items to returnInteger

Request Example

curl --request GET \
     --url 'https://booking.guesty.com/api/reviews?channelId=airbnb2' \
     --header 'Accept: application/json; charset=utf-8' \
     --header 'authorization: Bearer <TOKEN>'

Response Example

{
  "data": [
    {
      "_id": "62d00273f3a7c7ba7e016a14",
      "externalReviewId": "test_6",
      "accountId": "5db59615f6fc3b001f8ee56f",
      "channelId": "airbnb2",
      "createdAt": "2022-07-14T11:44:02.563Z",
      "createdAtGuesty": "2022-07-14T11:45:08.137Z",
      "externalListingId": "604153909318094860",
      "externalReservationId": "HMTZ9DWB9W",
      "guestId": "62330bdc1e874f003681cf32",
      "listingId": "5f90114acc5b51002979b1e0",
      "rawReview": {
        "id": 661184254142632200,
        "reviewer_role": "guest",
        "reviewer_id": 334216375,
        "reviewee_role": "host",
        "reviewee_id": 256102206,
        "listing_id": 604153909318094800,
        "reservation_confirmation_code": "HMTZ9DWB9W",
        "hidden": false,
        "submitted": true,
        "overall_rating": 4,
        "public_review": "Good",
        "id_str": "661184254142632192",
        "reviewer_id_str": "334216375",
        "reviewee_id_str": "256102206",
        "listing_id_str": "604153909318094860",
        "expires_at": "2022-07-15T06:15:05.198Z",
        "first_completed_at": "2022-07-14T11:44:02.563Z",
        "submitted_at": "2022-07-14T11:44:55.556Z",
        "category_ratings_accuracy": 4,
        "category_ratings_communication": 4,
        "category_ratings_value": 4,
        "category_ratings_location": 4,
        "category_ratings_checkin": 4,
        "category_ratings_cleanliness": 4
      },
      "reservationId": "629208e3d5b216003488065e",
      "updatedAt": "2022-07-14T11:44:55.556Z",
      "updatedAtGuesty": "2022-07-14T11:45:08.137Z",
      "reviewReplies": []
    },
    {
      "_id": "62d00231f3a7c7ba7e016a12",
      "externalReviewId": "test_4",
      "accountId": "5db59615f6fc3b001f8ee56f",
      "channelId": "airbnb2",
      "createdAt": "2022-07-12T15:47:28.485Z",
      "createdAtGuesty": "2022-07-14T11:45:35.871Z",
      "externalListingId": "52913873",
      "externalReservationId": "HMB29XEXRR",
      "guestId": "62b29a8a2bd3090033289b03",
      "listingId": "5f858abd3152ad002d31b40c",
      "rawReview": {
        "id": 660625731429787100,
        "reviewer_role": "guest",
        "reviewer_id": 465423078,
        "reviewee_role": "host",
        "reviewee_id": 389742996,
        "listing_id": 52913873,
        "reservation_confirmation_code": "HMB29XEXRR",
        "hidden": false,
        "submitted": true,
        "overall_rating": 5,
        "public_review": "Fantastic views of the city, very nicely furnished, secure, good cooking facilities and air con, beds were very comfy - would stay again.\n\nStaircase to a double bed upstairs with private balcony, all downstairs bedroom have their own doors - one has balcony access, the other an on suite. Bathrooms are all very clean and showers are huge! An amazing wrap-around balcony with seating. \n\nFeels like it’s barely just being held together in some places so be careful. ie rusted balcony railings, dodgy wardrobe door and toilet flush, missing bed slats - but nothing that’s going to ruin your stay, the apartment was a lot of fun and the spiral stairs are indeed as good as they look!",
        "id_str": "660625731429787188",
        "reviewer_id_str": "465423078",
        "reviewee_id_str": "389742996",
        "listing_id_str": "52913873",
        "expires_at": "2022-07-14T11:45:24.102Z",
        "first_completed_at": "2022-07-12T15:47:28.485Z",
        "submitted_at": "2022-07-12T15:56:22.173Z",
        "category_ratings_cleanliness": 4,
        "category_ratings_accuracy": 5,
        "category_ratings_location": 4,
        "category_ratings_checkin": 5,
        "category_ratings_communication": 3,
        "category_ratings_value": 5
      },
      "reservationId": "62b29a8a2bd3090033289b13",
      "updatedAt": "2022-07-12T15:56:22.173Z",
      "updatedAtGuesty": "2022-07-14T11:45:35.871Z",
      "reviewReplies": []
    },
    {
      "_id": "62d00252f3a7c7ba7e016a13",
      "externalReviewId": "test_5",
      "accountId": "5db59615f6fc3b001f8ee56f",
      "channelId": "airbnb2",
      "complexId": "622736a59aa7300032e69baa",
      "createdAt": "2022-07-10T07:08:11.577Z",
      "createdAtGuesty": "2022-07-14T11:45:17.612Z",
      "externalListingId": "45476625",
      "externalReservationId": "HMWXYH8TAK",
      "guestId": "6273f7ea48c08700326799e1",
      "listingId": "5f9010ffccce44002ab01f5d",
      "rawReview": {
        "id": 660625585429962100,
        "reviewer_role": "guest",
        "reviewer_id": 85029137,
        "reviewee_role": "host",
        "reviewee_id": 244829847,
        "listing_id": 45476625,
        "reservation_confirmation_code": "HMWXYH8TAK",
        "hidden": false,
        "submitted": true,
        "overall_rating": 4,
        "public_review": "Very clean and spacious apartment, well appointed and comfortable. Having a washing machine and drying rack was very helpful. Good communication with the host. Key pick up and drop off was a bit inconvenient, but manageable.",
        "id_str": "660625585429962138",
        "reviewer_id_str": "85029137",
        "reviewee_id_str": "244829847",
        "listing_id_str": "45476625",
        "expires_at": "2022-07-14T11:45:06.698Z",
        "first_completed_at": "2022-07-10T07:08:11.577Z",
        "submitted_at": "2022-07-10T07:11:59.083Z",
        "category_ratings_location": 5,
        "category_ratings_cleanliness": 5,
        "category_ratings_accuracy": 5,
        "category_ratings_value": 5,
        "category_ratings_checkin": 5,
        "category_ratings_communication": 5
      },
      "reservationId": "62a1e8fe79605c0035590466",
      "subListingId": "6165d405fcc96b002da2a5b5",
      "updatedAt": "2022-07-10T07:11:59.083Z",
      "updatedAtGuesty": "2022-07-14T11:45:17.612Z",
      "reviewReplies": []
    }
  ],
  "limit": 100,
  "skip": 0
}

Retrieving All Reviews on a Specific Listing

This GET request retrieves all reviews published for stays at a single listing, depending on the filters specified.

Query Parameters

ParameterDetailsData Type
channelIdOne of two booking channels: airbnb2 or bookingCom.String
listingIdID of the listing.String
startDateDefines the start of a date range (YYYY-MM-DD).String
endDateDefines the end of a date range (YYYY-MM-DD).String
skipThe number of items to skip over before returning a result.Integer
limitThe number of items to return.Integer

Request Example

curl --request GET \
     --url 'https://booking.guesty.com/api/reviews?channelId=airbnb2&listingId=5f90114acc5b51002979b1e0' \
     --header 'Accept: application/json; charset=utf-8' \
     --header 'authorization: Bearer <TOKEN>'

Response Example

{
  "data": [
    {
      "_id": "62d00273f3a7c7ba7e016a14",
      "externalReviewId": "test_6",
      "accountId": "5db59615f6fc3b001f8ee56f",
      "channelId": "airbnb2",
      "createdAt": "2022-07-14T11:44:02.563Z",
      "createdAtGuesty": "2022-07-14T11:45:08.137Z",
      "externalListingId": "604153909318094860",
      "externalReservationId": "HMTZ9DWB9W",
      "guestId": "62330bdc1e874f003681cf32",
      "listingId": "5f90114acc5b51002979b1e0",
      "rawReview": {
        "id": 661184254142632200,
        "reviewer_role": "guest",
        "reviewer_id": 334216375,
        "reviewee_role": "host",
        "reviewee_id": 256102206,
        "listing_id": 604153909318094800,
        "reservation_confirmation_code": "HMTZ9DWB9W",
        "hidden": false,
        "submitted": true,
        "overall_rating": 4,
        "public_review": "Good",
        "id_str": "661184254142632192",
        "reviewer_id_str": "334216375",
        "reviewee_id_str": "256102206",
        "listing_id_str": "604153909318094860",
        "expires_at": "2022-07-15T06:15:05.198Z",
        "first_completed_at": "2022-07-14T11:44:02.563Z",
        "submitted_at": "2022-07-14T11:44:55.556Z",
        "category_ratings_accuracy": 4,
        "category_ratings_communication": 4,
        "category_ratings_value": 4,
        "category_ratings_location": 4,
        "category_ratings_checkin": 4,
        "category_ratings_cleanliness": 4
      },
      "reservationId": "629208e3d5b216003488065e",
      "updatedAt": "2022-07-14T11:44:55.556Z",
      "updatedAtGuesty": "2022-07-14T11:45:08.137Z",
      "reviewReplies": []
    }
  ],
  "limit": 100,
  "skip": 0
}

Retrieving a Specific Review

This GET request retrieves the review published for for a specific stay.

Query Parameters

ParameterDetailsData Type
reservationIdID of the reservation.String
externalReservationIdChannel reservation ID.String
externalReviewIdChannel review ID.String

Request Example (Review ID)

curl --request GET \
     --url 'https://booking.guesty.com/api/reviews?externalReviewId=test_2' \
     --header 'Accept: application/json; charset=utf-8' \
     --header 'authorization: Bearer <TOKEN>'

Response Example(Review ID)

{
  "data": [
    {
      "_id": "62d001c8f3a7c7ba7e016a0f",
      "externalReviewId": "test_2",
      "accountId": "5db59615f6fc3b001f8ee56f",
      "channelId": "bookingCom",
      "createdAt": "2022-07-14T12:00:38.000Z",
      "createdAtGuesty": "2022-07-14T11:38:27.934Z",
      "externalComplexId": "7254686",
      "externalListingId": "725468602",
      "externalReservationId": "3965817397",
      "guestId": "628e5f5c34afd40033be6e8f",
      "listingId": "5f9010ffccce44002ab01f5d",
      "rawReview": {
        "listingId": "6075ee4717dcf40032e650a0",
        "last_change_timestamp": "2022-07-14 12:31:12",
        "reservation_id": 3965817397,
        "content": {
          "positive": "Good location and generally well fitted out. Great having an en-suite for each bedroom.",
          "negative": "Property was not fully equipped for the number of guests,  as I guess due to past breakages not being replaced, there were not enough crockery or glassware. This was addressed for the second night. The fan in the top bedroom did not work, nor the iron in the boiler cupboard or the USB ports on one of the sockets in the top bedroom. This was reported but not put right during our short stay. The shower in the top floor bedroom took a good while to start to flow properly and randomly cut out though other 2 showers were fine; maybe this was due to lack of pressure as this was the highest point in the building. This may seem a bit of a list but I include it so that both the management can deal with issues and future guests are warned.",
          "headline": "Generally a good experience and a comfortable place for a short break in a great city.",
          "language_code": "en-gb"
        },
        "review_id": "EAZ_y__14JA",
        "url": "https://supply-xml.booking.com/review-api/properties/7254686/reviews/EAZ_y__14JA",
        "reviewer": {
          "is_genius": true,
          "country_code": "gb",
          "name": "Michael"
        },
        "reply": null,
        "created_timestamp": "2022-07-14 12:00:38",
        "scoring": {
          "staff": 7.5,
          "comfort": 7.5,
          "review_score": 6,
          "location": 7.5,
          "value": null,
          "clean": 7.5,
          "facilities": 5
        }
      },
      "reservationId": "628e8209cf403a0035de866d",
      "updatedAt": "2022-07-14T12:31:12.000Z",
      "updatedAtGuesty": "2022-07-14T11:40:28.133Z",
      "reviewReplies": []
    }
  ],
  "limit": 100,
  "skip": 0
}

What’s Next

To learn how to retrieve review statistics for your listings. Click on the link below.