google-hotels/
hotel-details

ホテルIDでGoogleホテル上のプロフィールを丸ごと取得します。連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金まで含みます。

Google Hotel Details API

予約サイト別の料金
口コミの話題
評価の分布
周辺エリアの評価
1リクエストあたり2クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Google Hotel Details

Googleホテルの詳細ページには、住所、電話番号、チェックイン時刻、設備一覧に加えて、星ごとの評価の割合、立地や朝食といった話題ごとの好意的・否定的な言及数、他の口コミサイトの評価まで、宿泊者の声が集約されています。同じ宿泊に対する各予約サイトとホテル公式サイトの料金と合わせれば、料金の整合性チェック、競合ホテルとの比較、ホテル紹介ページの充実に使えます。

Google Hotel Details API の主な機能

  • 予約サイトごとの料金offers には各販売元の1泊料金と予約リンクが入り、is_official、is_sponsored、free_cancellation_until で公式料金、広告枠、無料キャンセル可能なプランを区別できます。
  • 宿泊者が話題にしていることreview_topics は Wellness や Breakfast などの話題ごとに positive_count、negative_count、mentions_count を返し、滞在のどの部分が好評か不評かがわかります。
  • 評価の分布と他サイトの評価rating_distribution は星ごとの口コミの割合、other_reviews は Tripadvisor などのサイトの評価、口コミ件数、抜粋を返します。
  • 周辺エリアの評価location_scores は総合、観光・アクティビティ、飲食店、交通、空港アクセスを1〜5で評価し、エリア名と座標も付きます。
  • ホテルの基本情報を1行でaddress、phone、website、check_in_time、check_out_time、利用できる設備、紹介文、写真がまとめて返ります。
  • 指定日程の料金check_in、check_out、currency で料金の対象となる宿泊を指定でき、日程を省略すると明日から1泊の料金になります。

Google Hotel Details API のパラメータ

パラメータ必須説明
hotel_id必須Google Hotels API の結果の id フィールドにあるホテルID。
check_in任意チェックイン日(YYYY-MM-DD、今日以降)。check_out と一緒に指定します。どちらも省略すると明日から1泊の料金になります。
check_out任意チェックアウト日(YYYY-MM-DD)。check_in より後で、最長30泊までです。
currency任意料金に使う3文字の通貨コード(USD、EUR など)。
location_code任意検索市場のロケーションコード。既定値は2840(米国)です。
language_code任意ホテル詳細の言語コード。既定値は en です。

Google Hotel Details API の使い方

ホテル検索で得たホテルIDを送り、そのホテルを1行で読み取ります。

  1. {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} を /v1/google-hotels/hotel-details に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からホテルを読み取ります。has_more と results.next_cursor は通常のページングルールに従い、この1行の結果では空になります。
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Google Hotel Details API の主なユースケース

  • 料金の整合性チェック: is_official の公式料金と、同じ日程のオンライン旅行会社の料金を比べ、公式より安く出している販売元を見つけます。
  • 競合ホテルとの比較: 近隣ホテルの rating_distribution、review_topics、location_scores を並べ、どこで優位か、どこで劣るかを確認します。
  • ホテル紹介ページの充実: 住所、設備、チェックイン時刻、写真、周辺エリアの評価を1回の照会で取得し、旅行サービスのホテルページに反映します。
  • 宿泊者の声の分析: review_topics を negative_count の多い順に並べ、騒音や朝食など不満の多い項目を洗い出します。

Google Hotel Details API 活用のヒント

  • 最近の Google Hotels API 検索で得たホテルIDを使えば、1回2クレジットのリクエストで目的のホテルを確実に取得できます。
  • 検索時と同じ check_in、check_out、currency を指定すると、予約サイトの料金が検索結果の料金とそろいます。
  • 販売元を比べる前に is_sponsored で広告枠を除くと、比較結果が偏りません。
  • 評価の分布をグラフにするときは、rating_distribution.share を0〜1の割合として扱います。

Google Hotel Details API 以外に別の種類の公開Google Hotelsデータが必要な場合は、これらのAPIをご利用ください。

  • Google Hotels API — 目的地でGoogleホテルを検索し、各ホテルの指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、ホテルIDを返します。
  • Hotel Price Tracker API — ホテルIDでGoogleホテルの料金カレンダーを取得し、この先およそ6〜8週間のチェックイン日ごとの最安1泊料金を返します。

他のプラットフォームを見る

Google Hotelsのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Google Hotel Details API — よくある質問

Google Hotel Details API は、ホテルIDでGoogleホテルの詳細を取得するAPIで、連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、他サイトの評価、予約サイトごとの料金を返します。

Google Hotels API が返す各行の id フィールドにホテルIDが入っているので、その値を hotel_id に指定します。

その宿泊についてGoogleホテルが表示する予約サイトが並びます。ホテル公式サイトが参加している場合はそれも含まれ、is_official で示されます。

rating_distribution で星ごとの割合、review_topics で話題ごとの好意的・否定的な言及数を示し、other_reviews で外部の口コミサイトの評価と口コミの抜粋を補います。

1リクエスト2クレジットで、送った hotel_id に対応するホテルを返します。