POST/v1/hotels/reviews

Get hotel reviews

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

Share

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 Parameters

No path or query params are required.

Request Body Schema

hotelId
stringYes
language
enum
eneszh
Yes

Success Response

Returns review entries and provider metadata.

Response Body Schema

language
enum
eneszh
Yes
reviews
arrayYes
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
liveMode
booleanYes
True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

Example

bash
bash
curl -X POST https://api.sandbox.travelandz.com/v1/hotels/reviews \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'