住客点评 API

通过分享经过验证的旅行者撰写的房源评价来提高转化率。

概述

Expedia Group 要求最近完成住宿的旅客对酒店进行评分，并分享他们的入住体验的书面评价。Rapid Guest Reviews API 让您可以访问数千万条此类书面酒店评论，以便您可以在您的网站、平台和应用程序上向旅行者展示这些评论。

其他旅行者的真实体验可以帮助您的客户做出正确的旅行预订决定，并对他们的住宿建立合理的预期。

如何操作

您需要在 Guest Reviews 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 请求

您可以通过多种方式调整您的 Guest Reviews 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 代表。