API de avaliações dos hóspedes
Promova conversões compartilhando avaliações propriedade escritas por viajantes verificados.
Visão geral
Expedia Group Os viajantes que concluíram uma estadia recentemente são convidados a avaliar as propriedades e compartilhar avaliações escritas sobre sua experiência. A API Rapid Guest Reviews dá acesso a dezenas de milhões dessas avaliações escritas propriedade, para que você possa mostrá-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 de reserva para sua viagem e estabelecer expectativas adequadas para sua estadia.
Como funciona
Você incluirá um identificador propriedade e um idioma na sua solicitação da 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, título e texto da avaliação e nome do avaliador.
- 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
,friends
epet
. - O
trip_reason
associado, incluindobusiness
,leisure
,business_and_leisure
oufriends_and_family
. - Quaisquer respostas escritas do propriedade a uma avaliação específica de um 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
Há várias maneiras de ajustar sua solicitação da API de Avaliações de Hóspedes para receber as avaliações de viajantes mais relevantes na resposta. Dessa forma, você pode adaptar as avaliações no seu site ou plataforma para melhor atender ao seu público.
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 viajando 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 compra 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.