Word of mouth is the best marketing strategy!

📘

Review basics

  • Please notice that the rating is from 0 to 100, so it is not a star rating!
  • Multiple languages: please only push it once in the original language to Holidu. Holidu offers a automatic translation to the customer, sending the same review multiple times would lead to a wrong overall rating and lost of trust by the customers.
  • To update the reviews, you need to PUSH the entire review object. Updates for single fields are not possible.
  • Reviews is an incremental update endpoint. If you push an object it will be added to the existing reviews or if the review already exists it will be updated (to detect a review as an existing one, the fields customerName, title, text are taken into account)
  • Deletion of reviews is currently not supported. If you push an empty list of reviews it will be ignored.

Reviews are the best advertisement for your properties. Tests have shown that reviews are one of the most important factors travellers based their decision on. So make sure to push us all your reviews. Reviews with more information, like text, name of the traveller, travelDate have a bigger impact than pure ratings.

FieldTypeRequiredUsage
customerNamestring
titlestringSummary of the content. e.g. "Beautiful stay"
countrystringCountry from where the customer is.
The options are:

- DE, ES, IT, NL, FR, GB, DK, AT, CH, BE, NO, PL, SE, PT, CA, AU, IE, BR, NZ, US
travelDatedateDate of arrival of the customer to the accommodation.
Format: 2022-07-04
reviewDatedate-timeDate when the review was given.
Format: 2022-07-04 20:10:10
globalRatingint32YESThe overall rating of the entire stay. This ranges from 0 to 100.
locationint32This ranges from 0 to 100.
localServiceint32This ranges from 0 to 100.
furnishingsint 32This ranges from 0 to 100.
cleanlinessint32This ranges from 0 to 100.
valueForMoneyint 32This ranges from 0 to 100.
beachint32This ranges from 0 to 100.
accommodationint32This ranges from 0 to 100.
hostint32This ranges from 0 to 100.
languagestringThe language of the review. ONLY push it once in the original language, we will translate it automatically.
textstringExample: "Great stay, very well located apartment"
positiveTextstringExample: "Wonderful accommodation with great services"
negativeTextstringExample: "Location far from city centre"

REVIEWS JSON object

[
     {
          "customerName": "John",
          "title": "Beautiful stay",
          "country": "DE",
          "travelDate": "2017-07-31",
          "reviewDateTime": "2022-08-03 11:52:41",
          "globalRating": 90,
          "location": 90,
          "localService": 95,
          "furnishings": 85,
          "cleanliness": 70,
          "valueForMoney": 100,
          "beach": 85,
          "accommodation": 80,
          "host": 100,
          "language": "en",
          "text": "Great stay, very well located apartment. I will come back for sure, and next time I will make sure I bring my dog, the property has a huge garden so Fluffy can play and it is perfectly allowed",
          "positiveText": "Wonderful accommodation with great services",
          "negativeText": "Location far from city center"
     }
]