旅客評論 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 業務代表。