旅客評論 API

透過分享經認證旅客撰寫的旅宿評論，來提升轉換率。

簡介

Expedia Group 我們誠摯邀請近期結束住宿的旅客為住宿地點評分，並分享您的住宿體驗心得。透過 Rapid Guest Reviews 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 Group 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 Group 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 業務代表。