google-hotels/
hotel-prices

ホテルIDでGoogleホテルの料金カレンダーを取得し、チェックイン日ごとの最安1泊料金を返します。開始日から通常6〜8週間分をカバーします。

Hotel Price Tracker API

日別の料金カレンダー
チェックイン日ごとに1行
通貨を指定
ホテルIDで照会
1リクエストあたり4クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Hotel Price Tracker

Googleホテルの料金カレンダーは、1つのホテルについて、この先数週間の各日からチェックインして1泊した場合の最安料金を並べたものです。この1泊料金を時系列で見ると、平日と週末の差、繁忙期のピーク、予約にいちばん安いタイミングがわかり、料金の追跡、収益の振り返り、旅行計画に役立ちます。

Hotel Price Tracker API の主な機能

  • カレンダーを行単位で取得各行が1つのチェックイン日で、check_out はその翌日、price.amount、price.currency、整形済みの料金がその夜の最安料金を示します。
  • 1回の照会で数週間分1回の照会で通常6〜8週間分のチェックイン日をカバーするため、日付ごとに料金を調べる必要がありません。
  • 開始日を指定可能check_in でカレンダーの開始日を決め、check_out と一緒に指定します。省略すると明日から始まります。
  • ホテルと日付で各行を特定各行に hotel_id と name が入り、id はホテルIDとチェックイン日を組み合わせた値なので、繰り返し実行した結果を簡単にまとめられます。

Hotel Price Tracker API のパラメータ

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

Hotel Price Tracker API の使い方

ホテルIDを送り、チェックイン日ごとに1行ずつ読み取ります。

  1. {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} を /v1/google-hotels/hotel-prices に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から日付ごとの料金を読み取り、has_more が true なら results.next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-prices" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Hotel Price Tracker API の主なユースケース

  • いちばん安い日を探す: price.amount で並べ替え、この先数週間で最も安いチェックイン日を選んで旅行日程を組みます。
  • 平日と週末の料金差: check_in の曜日ごとにまとめ、金曜・土曜の夜が平日よりどれだけ高いかを算出します。
  • 料金変動の追跡: カレンダーを定期的に取得し、同じ id の料金を回ごとに比べて、ホテルがいつ値上げ・値下げしたかを把握します。
  • 競合ホテルとの比較: 近隣の複数ホテルのカレンダーを同じ通貨で取得し、check_in ごとに並べて夜ごとの価格優位を比べます。

Hotel Price Tracker API 活用のヒント

  • ホテルIDとチェックイン日を組み合わせた id を保存キーにすれば、毎日再実行しても同じ夜のデータが更新され、重複行になりません。
  • さらに先の日付を見たいときは、check_in を後ろにずらしてもう一度リクエストします。
  • 複数のホテルや複数回の結果を比べるときは、currency を固定しましょう。
  • 返される日数にかかわらず1リクエスト4クレジットなので、日付ごとに料金を調べるよりカレンダーでまとめて取るほうが割安です。

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

  • Google Hotels API — 目的地でGoogleホテルを検索し、各ホテルの指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、ホテルIDを返します。
  • Google Hotel Details API — ホテルIDでGoogleホテル上のプロフィールを取得し、連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金を返します。

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

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

Hotel Price Tracker API — よくある質問

Hotel Price Tracker API は、ホテルIDでGoogleホテルの料金カレンダーを取得するAPIで、この先およそ6〜8週間のチェックイン日ごとの最安1泊料金を返します。

各行は1泊分の料金です。check_out は check_in の翌日で、price はその夜の最安料金です。

開始日から通常6〜8週間です。check_in を指定すればその日から、省略すれば明日から始まります。

currency に USD や EUR などの3文字コードを指定します。各行に料金の通貨が記載されます。

1リクエスト4クレジットで、ホテル1軒のカレンダー全体を返します。