POST/v1/hotels/reviews
Get hotel reviews
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
| Method | Path | Auth |
|---|---|---|
POST | /v1/hotels/reviews | Required API key |
| Header | Description |
|---|---|
Authorization | Bearer <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-Type | Use application/json for requests with a body. |
Request Body Schema
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
hotelId | string | Yes | - | |
language | enum | en, es, zh | Yes | - |
Success Response
Returns review entries and provider metadata.
Response Body Schema
| Property | Type | Details | Required | Notes |
|---|---|---|---|---|
language | enum | en, es, zh | Yes | - |
reviews | array | Yes | - | |
name | string | Yes | - | |
relativePublishTimeDescription | string | Yes | - | |
text | object | Yes | - | |
text | string | Yes | - | |
languageCode | string | Yes | - | |
originalText | object | Yes | - | |
text | string | Yes | - | |
languageCode | string | Yes | - | |
rating | number | Yes | - | |
authorAttribution | object | Yes | - | |
displayName | string | Yes | - | |
uri | string | Yes | - | |
photoUri | string | Yes | - | |
publishTime | string | Yes | - | |
flagContentUri | string | Yes | - | |
googleMapsUri | string | Yes | - | |
visitDate | object | Yes | - | |
year | number | Yes | - | |
month | number | Yes | - | |
day | number | Yes | - | |