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