Guest Reviews API

検証済みの旅行者が書いた施設のレビューを共有することで、コンバージョンを促進します。

概要

Expedia Group最近宿泊を終えた旅行者に、宿泊施設を評価してもらい、その体験談を口コミとして投稿してもらいます。Rapid Guest Reviews APIを使えば、何千万件もの施設のレビューにアクセスすることができます。

他の旅行者のリアルな体験談は、あなたの顧客が旅行の正しい予約を決定し、滞在に対する適切な期待を確立するのに役立ちます。

仕組み

ゲストレビューAPIリクエストに施設識別子と言語を含めることで、返されるレビューが正しい施設のものであり、旅行者が好む言語であることを確認できます。user-generatedのコンテンツから、施設のレビューを最大100件返します。

Guest Reviews 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 時間までキャッシュされ、表示速度の向上に役立ちます。

Guest Reviews 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 Guest Reviews API について詳しくは、エクスペディアの担当者にお問い合わせください。