Developer Hub
これは自動生成された翻訳です。

Guest Reviews API

認証済みの旅行者が書いた 施設 のレビューを共有して、コンバージョンを促進しましょう。

概要

Expedia Group最近宿泊を終えた旅行者の皆様には、宿泊施設の評価や、ご体験についての感想を文章で投稿していただくようお願いしております。Rapid Guest Reviews APIを利用すれば、数千万件に及ぶこうした 施設 のレビューにアクセスできるため、自社のサイト、プラットフォーム、アプリ上で旅行者にそれらのレビューを表示させることができます。

他の旅行者の実際の体験談は、お客様がご自身の旅行に最適な予約を決定し、滞在に対する適切な期待を抱く上で役立ちます。

仕組み

Guest Reviews APIへのリクエストには、施設という識別子と言語を指定してください。これにより、返されるレビューが正しい施設に関するものであり、旅行者が希望する言語で表示されるようになります。その後、user-generatedのコンテンツデータベースから、その「施設」に関するレビューを最大100件表示いたします。

Guest Reviews API レスポンスには以下の項目が含まれます。

  • 総合評価、レビューのタイトルと本文、およびレビュアーの名前。
  • 旅行者の滞在月・年およびレビュー投稿日。
  • 同行者に関する情報:対象となるカテゴリーには、selfpartnerfamily_with_childrenfamilyfriends、および が含まれますpet
  • 関連するtrip_reason には、businessleisurebusiness_and_leisure、または friends_and_family が含まれます。
  • 施設 から特定の旅行者のレビューに対して寄せられた書面による返信と、その返信の日付。

返信例

{
  "verified": {
    "recent": [
      {
        "verification_source": "Expedia Group verified review",
        "title": "Definitely staying again",
        "date_submitted": "2026-02-11T18:19:40Z",
        "rating": "5",
        "reviewer_name": "Bill",
        "stay_date": "2026-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": "2026-02-10T11:15:01Z",
        "rating": "2",
        "reviewer_name": "Gregory",
        "stay_date": "2026-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": "2026-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"

公開要件

宿泊施設の検索・予約プラットフォーム上で、当社の認証済みレビューにアクセスし、表示するには、公開要件を遵守していただく必要があります。

>> ゲストレビューAPIのリリース要件についてご覧ください

Rapid Guest Reviews API について詳しくは、エクスペディアの担当者にお問い合わせください。

このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。