Reviews

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.

Field

Type

Required

Usage

customerName

string

title

string

Summary of the content. e.g. "Beautiful stay"

country

string

Country 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

travelDate

date

Date of arrival of the customer to the accommodation.

  • *Format:** 2022-07-04

reviewDate

date-time

Date when the review was given.

  • *Format:** 2022-07-04 20:10:10

globalRating

int32

YES

The overall rating of the entire stay. This ranges from 0 to 100.

location

int32

This ranges from 0 to 100.

localService

int32

This ranges from 0 to 100.

furnishings

int 32

This ranges from 0 to 100.

cleanliness

int32

This ranges from 0 to 100.

valueForMoney

int 32

This ranges from 0 to 100.

beach

int32

This ranges from 0 to 100.

accommodation

int32

This ranges from 0 to 100.

host

int32

This ranges from 0 to 100.

language

string

The language of the review. ONLY push it once in the original language, we will translate it automatically.

text

string

Example: "Great stay, very well located apartment"

positiveText

string

Example: "Wonderful accommodation with great services"

negativeText

string

Example: "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"
     }
]