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
stringSí
language
enum
eneszh
Sí

Respuesta exitosa

Devuelve review entries and provider metadata.

Esquema del cuerpo de la respuesta

language
enum
eneszh
Sí
reviews
arraySí
reviews[]name
stringSí
reviews[]relativePublishTimeDescription
stringSí
reviews[]text
objectSí
reviews[]texttext
stringSí
reviews[]textlanguageCode
stringSí
reviews[]originalText
objectSí
reviews[]originalTexttext
stringSí
reviews[]originalTextlanguageCode
stringSí
reviews[]rating
numberSí
reviews[]authorAttribution
objectSí
reviews[]authorAttributiondisplayName
stringSí
reviews[]authorAttributionuri
stringSí
reviews[]authorAttributionphotoUri
stringSí
reviews[]publishTime
stringSí
reviews[]flagContentUri
stringSí
reviews[]googleMapsUri
stringSí
reviews[]visitDate
objectSí
reviews[]visitDateyear
numberSí
reviews[]visitDatemonth
numberSí
reviews[]visitDateday
numberSí
liveMode
booleanSí
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>'