POST/v1/hotels/reviews

Obtener reviews de hotel

Devuelve reviews almacenadas para un hotel y un idioma específico para enriquecer páginas de detalle.

Compartir

Devuelve reviews almacenadas para un hotel y un idioma específico para enriquecer páginas de detalle.

Endpoint

MétodoRutaAuth
POST/v1/hotels/reviewsAPI key requerida
Headers obligatorios:
HeaderDescripción
AuthorizationBearer <secret_key>. El secret se muestra una sola vez al crear la credencial.
X-Travelandz-Id<public_key>:<profile_code>. El profile_code es el codigo de Developer Profile con prefijo dp_ que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
Content-TypeUsa application/json para peticiones con cuerpo.

Parámetros de la petición

No requiere parámetros de ruta ni query.

Esquema del cuerpo de la petición

hotelId
string
language
enum
eneszh

Respuesta exitosa

Devuelve review entries and provider metadata.

Esquema del cuerpo de la respuesta

language
enum
eneszh
reviews
array
reviews[]name
string
reviews[]relativePublishTimeDescription
string
reviews[]text
object
reviews[]texttext
string
reviews[]textlanguageCode
string
reviews[]originalText
object
reviews[]originalTexttext
string
reviews[]originalTextlanguageCode
string
reviews[]rating
number
reviews[]authorAttribution
object
reviews[]authorAttributiondisplayName
string
reviews[]authorAttributionuri
string
reviews[]authorAttributionphotoUri
string
reviews[]publishTime
string
reviews[]flagContentUri
string
reviews[]googleMapsUri
string
reviews[]visitDate
object
reviews[]visitDateyear
number
reviews[]visitDatemonth
number
reviews[]visitDateday
number
liveMode
boolean
True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Ejemplo

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>'