住客点评 API
通过分享经过验证的旅行者撰写的酒店评论来推动转化。
概述
Expedia Group 要求最近完成住宿的旅行者对酒店进行评分并分享他们的体验的书面评论。快速宾客评论 API 可让您访问数千万条此类书面酒店评论,以便您可以在您的网站、平台和应用程序上向旅行者展示这些评论。
其他旅行者的真实体验可以帮助您的客户为他们的旅行做出正确的预订决定并为他们的住宿建立适当的期望。
如何操作
您将在宾客点评 API 请求中包含酒店标识符和语言,以确保返回的点评针对正确的酒店,并使用旅行者首选的语言。然后,我们从 user-generated 内容库存中返回该房产的最多 100 条评论。
住客点评 API 响应包括:
- 总体评分、评论标题和正文以及评论者的姓名。
- 旅行者入住的月份和年份以及提交点评的日期。
- 任何旅行同伴的信息:类别包括
self
、partner
、family_with_children
、family
、friends
和pet
。 - 关联的
trip_reason
包括business
、leisure
、business_and_leisure
或friends_and_family
。 - 酒店对特定旅客点评的任何书面回复以及回复日期。
示例响应
{
"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"
}
]
}
]
}
}
实时调用后,点评可以缓存长达 48 小时,以帮助提高显示速度。
筛选住客点评 API 请求
有几种方法可以调整您的客户评论 API 请求,以便在响应中接收最相关的旅行者评论。这可以帮助您定制网站或平台上的点评,使其最适合您的旅客受众。
例如,您可以在请求中指定是否只想接收商务旅客留下的评论、以指定语言撰写的评论或携带宠物旅行的客人留下的评论。
示例请求
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"
上线要求
要在您的住宿购物和预订环境中访问和显示我们经过验证的评论,您必须遵守启动要求。
要进一步了解 Rapid 住客点评 API,请联系您的 Expedia 代表。