API de avaliações dos hóspedes

Aumente a conversão compartilhando avaliações de viajantes verificados com a hashtag propriedade.

Visão geral

Expedia Group Os viajantes que concluíram recentemente uma estadia são convidados a avaliar as propriedades e compartilhar comentários escritos sobre sua experiência. A API Rapid Guest Reviews dá acesso a dezenas de milhões dessas avaliações escritas com a hashtag propriedade, para que você possa exibi-las aos viajantes em seus sites, plataformas e aplicativos.

As experiências reais de outros viajantes podem ajudar seus clientes a tomar a decisão certa ao reservar sua viagem e a criar expectativas realistas para a estadia.

Como funciona

Você deverá incluir um identificador propriedade e o idioma na sua solicitação à API de Avaliações de Hóspedes para garantir que as avaliações retornadas sejam para o propriedade correto e no idioma preferido do viajante. Em seguida, retornamos até 100 avaliações para esse propriedade do nosso estoque de conteúdo user-generated.

A resposta da API de avaliações de hóspedes inclui:

A classificação geral, o título e o texto da avaliação, e o nome do autor da avaliação.
Mês e ano da estadia do viajante e data de envio da avaliação.
Informações sobre quaisquer companheiros de viagem: as categorias incluem self, partner, family_with_children, family, friendse pet.
O trip_reasonassociado, incluindo business, leisure, business_and_leisureou friends_and_family.
Quaisquer respostas escritas da propriedade a uma avaliação específica de viajante e a data da resposta.

Exemplo de resposta

{
  "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"
          }
        ]
      }
    ]
  }
}

As avaliações podem ser armazenadas em cache após uma ligação por até 48 horas para melhorar a velocidade de exibição.

Filtragem da sua solicitação da API de avaliações de hóspedes

Existem diversas maneiras de ajustar sua solicitação à API de Avaliações de Hóspedes para receber as avaliações de viajantes mais relevantes na resposta. Isso pode ajudar você a adaptar as avaliações em seu site ou plataforma para melhor atender ao público viajante.

Por exemplo, você pode especificar em sua solicitação se deseja receber apenas avaliações deixadas por viajantes a negócios, avaliações escritas em um idioma específico ou avaliações de hóspedes que viajam com animais de estimação.

Exemplo de solicitação

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 lançamento

Para acessar e exibir nossas avaliações verificadas em seu ambiente de busca e reserva de hospedagem, você deve cumprir os requisitos de lançamento .

Para mais informações sobre a API de avaliações de hóspedes da Rapid, entre em contato com o seu representante da Expedia.