POST/v1/hotels/reviews

Hotelbewertungen abrufen

Returns stored hotel reviews for the requested hotel and language to enrich hotel detail pages.

Returns stored hotel reviews for the requested hotel and language to enrich hotel detail pages.

Endpoint

MethodPathAuth
POST/v1/hotels/reviewsRequired API key
Required headers:
HeaderDescription
AuthorizationBearer <secret_key>. The secret is shown only once when the credential is created.
X-Travelandz-Id<public_key>:<profile_code>. The profile_code is the dp_-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
Content-TypeUse application/json for requests with a body.

Request Body Schema

PropertyTypeDetailsRequiredNotes
hotelIdstringYes-
languageenum
eneszh
Yes-

Success Response

Returns review entries and provider metadata.

Response Body Schema

PropertyTypeDetailsRequiredNotes
languageenum
eneszh
Yes-
reviewsarrayYes-
reviews[]name
stringYes-
reviews[]relativePublishTimeDescription
stringYes-
reviews[]text
objectYes-
reviews[]texttext
stringYes-
reviews[]textlanguageCode
stringYes-
reviews[]originalText
objectYes-
reviews[]originalTexttext
stringYes-
reviews[]originalTextlanguageCode
stringYes-
reviews[]rating
numberYes-
reviews[]authorAttribution
objectYes-
reviews[]authorAttributiondisplayName
stringYes-
reviews[]authorAttributionuri
stringYes-
reviews[]authorAttributionphotoUri
stringYes-
reviews[]publishTime
stringYes-
reviews[]flagContentUri
stringYes-
reviews[]googleMapsUri
stringYes-
reviews[]visitDate
objectYes-
reviews[]visitDateyear
numberYes-
reviews[]visitDatemonth
numberYes-
reviews[]visitDateday
numberYes-