API de comentarios

Impulsa la conversión compartiendo reseñas de propiedades escritas por viajeros verificados.

Información general

Expedia Group Se pide a los viajeros que han completado recientemente una estancia que valoren los alojamientos y compartan opiniones escritas sobre su experiencia. La API de opiniones de huéspedes de Rapid te da acceso a decenas de millones de estas opiniones escritas sobre propiedades, para que puedas mostrarlas a los viajeros en tus sitios, plataformas y aplicaciones.

Las experiencias reales de otros viajeros pueden ayudar a tus clientes a tomar la decisión de reserva correcta para su viaje y a establecer expectativas adecuadas para su estancia.

Funcionamiento

Incluirás un identificador de propiedad y un idioma en tu solicitud de la API de opiniones de huéspedes para asegurarte de que las opiniones devueltas corresponden al alojamiento correcta y están en el idioma preferido por el viajero. A continuación, devolvemos hasta 100 opiniones para esa propiedad de nuestro inventario de contenidos de user-generated.

La respuesta de la API de comentarios de huéspedes incluye:

La puntuación global, el título y el texto de la reseña, y el nombre del reseñador.
Mes y año de la estancia del viajero y fecha de presentación de la revisión.
Información sobre cualquier compañero de viaje: las categorías incluyen self, partner, family_with_children, family, friendsy pet.
El trip_reasonasociado incluyendo business, leisure, business_and_leisure, o friends_and_family.
Cualquier respuesta escrita del alojamiento a una revisión específica del viajero y la fecha de la respuesta.

Ejemplo de respuesta

{
  "verified": {
    "recent": [
      {
        "verification_source": "Expedia verified review",
        "title": "Definitely staying again",
        "date_submitted": "2019-02-11T18:19:40Z",
        "rating": "5",
        "reviewer_name": "Bill",
        "stay_date": "2019-02",
        "trip_reason": "leisure",
        "travel_companion": "self",
        "text": "Staff very helpful and friendly. Pool was 18 meters deep, very strange."
      },
      {
        "verification_source": "Expedia verified review",
        "title": "Pool much too deep",
        "date_submitted": "2019-02-10T11:15:01Z",
        "rating": "2",
        "reviewer_name": "Gregory",
        "stay_date": "2019-01",
        "trip_reason": "friends_and_family",
        "travel_companion": "family_with_children",
        "text": "Bottom of the 18 meter pool was too scary. Staff were nice though.",
        "management_responses": [
          {
            "text": "Dear Guest, Thank you for your feedback. I hope we have the opportunity to welcome you back in the near future. Best regards, Kara (General Manager)",
            "date": "2019-02-11T14:36:54Z"
          }
        ]
      }
    ]
  }
}

Los comentarios pueden almacenarse en caché tras una llamada durante un máximo de 48 horas para mejorar la velocidad de visualización.

Cómo filtrar tu solicitud en la API de comentarios de los huéspedes

Hay varias formas de ajustar tu solicitud de la API de opiniones de huéspedes para recibir las opiniones de viajeros más relevantes en la respuesta. Esto puede ayudarte a adaptar los comentarios de tu sitio web o plataforma para que se ajusten mejor a los viajeros que los van a leer.

Por ejemplo, puedes especificar en tu solicitud si sólo quieres recibir reseñas dejadas por viajeros de negocios, reseñas escritas en un idioma concreto o reseñas de huéspedes que viajen con mascota.

Ejemplo de solicitud

curl -X GET "https://test.ean.com/v3/properties/12345/guest-reviews\
?language=fr-FR\
&filter=language\
&trip_reason=business" \
 -H "accept: application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1719329586"\
 -H "user-agent: TravelNow/3.30.112"

Requisitos de lanzamiento

Para acceder y mostrar nuestras opiniones verificadas en tu entorno de compra y reserva de alojamiento, debes cumplir los requisitos de lanzamiento de .

Ponte en contacto con tu representante de Expedia para recibir más información sobre la API de comentarios de huéspedes de Rapid.