google-hotels/
search

Googleホテルを目的地で検索し、各ホテルの指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、続けて使えるホテルIDを取得します。

Google Hotels API

目的地で検索
日程指定の料金
星評価と宿泊者評価
詳細照会用のホテルID
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Google Hotels

Googleホテルの検索結果1件には、ホテル名・星評価・地図上の位置に加えて、宿泊者評価、口コミ件数、写真、そして選んだ日程と通貨での最安1泊料金がまとめて載っています。これらを横に並べると、目的地のホテル供給を比べたり、料金と評価のバランスを見たり、個別のホテルを調べる前に候補を絞り込んだりできます。

Google Hotels API の主な機能

  • 旅行者と同じ言い方で検索query には hotels in new york のような目的地やホテル名を指定でき、Googleホテルが表示する順にホテルが返り、rank に各ホテルの順位が入ります。
  • 実際の宿泊日程で料金を取得check_in、check_out、currency で知りたい宿泊の条件を指定でき、各行にその日程と price.amount、price.currency、整形済みの料金が入ります。
  • 並べ替えと1泊料金の範囲指定sort_by で relevance、lowest_price、highest_rating、most_reviewed を切り替え、min_price と max_price で予算内のホテルだけに絞れます。
  • 全ホテルに評価の指標stars はホテルのクラス、rating は1〜5の宿泊者平均評価、reviews_count はその評価のもとになった口コミ件数です。
  • 座標と写真location に緯度・経度、images にGoogleが表示するホテル写真のURLが入ります。
  • 詳細照会に使えるホテルID各行の id はそのまま Google Hotel Details API と Hotel Price Tracker API に渡せ、url はGoogleホテルの該当ページを指します。
  • 1回で最大140軒results_limit は1〜140で指定でき、is_sponsored で広告枠のホテルを通常の掲載と分けて扱えます。

Google Hotels API のパラメータ

パラメータ必須説明
query必須目的地またはホテルの検索語。例:hotels in new york、ホテル名。
check_in任意チェックイン日(YYYY-MM-DD、今日以降)。check_out と一緒に指定します。どちらも省略すると明日から1泊の料金になります。
check_out任意チェックアウト日(YYYY-MM-DD)。check_in より後で、最長30泊までです。
currency任意料金と料金範囲に使う3文字の通貨コード(USD、EUR など)。
sort_by任意並び順:relevance、lowest_price、highest_rating、most_reviewed のいずれか。
min_price任意1泊料金の下限(currency の通貨)。
max_price任意1泊料金の上限(currency の通貨)。min_price を下回る値は指定できません。
location_code任意検索市場のロケーションコード。既定値は2840(米国)です。
language_code任意結果の言語コード。既定値は en です。
results_limit任意返すホテル数(1〜140)。既定値は18です。

Google Hotels API の使い方

目的地で検索し、1行ずつホテルを読み取ります。

  1. {"query": "hotels in new york", "currency": "USD", "results_limit": 18} を /v1/google-hotels/search に 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/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hotels in new york","currency":"USD","results_limit":18}'

Google Hotels API の主なユースケース

  • 目的地の料金相場を把握: 同じ日程で price.amount を stars や rating と並べ、都市ごとにホテルのクラス別の料金水準をつかみます。
  • 候補ホテルの絞り込み: 料金範囲内で rating と reviews_count が基準を満たすホテルを残し、その id を詳細照会や料金照会に回します。
  • 旅行日程の比較: 同じ query を check_in と check_out を変えて実行し、id で結合して日程ごとの料金の動きを比べます。
  • ホテル分布の地図化: location の緯度・経度に stars と料金を重ね、エリア内で手頃なホテルと高級ホテルがどこに集まるかを確認します。

Google Hotels API 活用のヒント

  • 比較に使う検索では毎回 currency を明示し、price.amount の単位をそろえましょう。
  • check_in と check_out は必ずセットで指定します。30泊を超える日程やチェックイン前のチェックアウトは、タスク作成前に弾かれます。
  • 後続の照会はホテル名ではなく id で結合しましょう。同じ都市のチェーンホテルは名前がよく似ています。
  • 返されたホテル1軒ごとに0.15クレジットかかるため、results_limit は実際に確認する件数に合わせましょう。

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

  • Google Hotel Details API — ホテルIDでGoogleホテル上のプロフィールを取得し、連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金を返します。
  • Hotel Price Tracker API — ホテルIDでGoogleホテルの料金カレンダーを取得し、この先およそ6〜8週間のチェックイン日ごとの最安1泊料金を返します。

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

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

Google Hotels API — よくある質問

Google Hotels API は、目的地やホテル名でGoogleホテルを検索し、各ホテルの指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、写真、ホテルIDを返すAPIです。

指定した check_in と check_out に基づく料金で、最長30泊まで指定できます。どちらも省略すると明日から1泊の料金になり、各行に料金の対象日程が入ります。

できます。min_price と max_price で1泊料金の範囲を指定し、sort_by で relevance、lowest_price、highest_rating、most_reviewed の順に並べられます。

検索結果は一覧レベルの項目です。ホテルの id を Google Hotel Details API に渡すと住所、設備、口コミの話題、予約サイトごとの料金を、Hotel Price Tracker API に渡すとチェックイン日ごとの料金を取得できます。

返されたホテル1軒ごとに0.15クレジットで、18軒なら2.7クレジットです。ホテルが見つからなかった検索には課金されません。