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行ずつ読み取ります。
- {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} を /v1/google-hotels/hotel-prices に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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クレジットなので、日付ごとに料金を調べるよりカレンダーでまとめて取るほうが割安です。
関連API
Hotel Price Tracker API 以外に別の種類の公開Google Hotelsデータが必要な場合は、これらのAPIをご利用ください。
- Google Hotels API — 目的地でGoogleホテルを検索し、各ホテルの指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、ホテルIDを返します。
- Google Hotel Details API — ホテルIDでGoogleホテル上のプロフィールを取得し、連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金を返します。