Google Hotelsは、ある目的地のホテルの星の数、宿泊者の評価、1泊あたりの料金、予約サイトごとのオファーを1つのページにまとめて表示します。旅行関連のプロダクト、料金比較ツール、レベニューマネージャーが必要とするのは、こうしたデータを行として扱える形、つまり比較するホテルの一覧、1つの施設の完全なレコード、そして日付によって料金がどう変わるかです。
2026-11-17、SocQはまさにそれを実現する3つのエンドポイントを備えたGoogle Hotelsプラットフォームを公開しました。3つのエンドポイントは、ホテルの id という1つのフィールドでつながります。このガイドでは、それぞれが返す内容、リクエスト、料金、使いどころを解説します。
結論:
POST /v1/google-hotels/searchで目的地を検索し、各ホテルのidを保存します。それをhotel_idとしてPOST /v1/google-hotels/hotel-detailsに渡すと設備、口コミのトピック、予約サイトごとのオファーが、POST /v1/google-hotels/hotel-pricesに渡すとチェックイン日ごとの1泊の最安料金が取得できます。結果はGET /v1/tasks/{task_id}をポーリングして取得します。
Google Hotelsの新エンドポイント
1 SocQクレジット = $0.005です。
| エンドポイント | 返す内容 | 料金 |
|---|---|---|
| Google Hotels API | 目的地のホテルと、星の数、宿泊者の評価、口コミ数、指定した日程の1泊の最安料金、所在地、写真、ホテルの id | ホテル1件あたり0.15クレジット($0.00075) |
| Google Hotel Details API | 1件のホテルの住所、電話番号、Webサイト、設備、立地スコア、評価の内訳、口コミのトピック、ほかのサイトでの評価、予約サイトごとのオファー | 1回の呼び出しあたり2クレジット($0.01) |
| Hotel Price Tracker API | チェックイン日ごとに1行で、そのホテルの1泊の最安料金。通常は6〜8週間分の日付 | 1回の呼び出しあたり4クレジット($0.02) |
認証と非同期タスクの流れ
SocQのリクエストはすべてAPIキーで認証し、送信、タスクのステータス確認、結果の取得のいずれにも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
収集処理はすべてバックグラウンドのタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信のレスポンスには data.task_id と data.status が含まれます。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
status が succeeded になると、レスポンスの data.results.items に正規化されたレコードの最初のページが含まれます。limit のデフォルトは50で、最大500まで指定できます。has_more がtrueの場合は、results.next_cursor を cursor として渡すと次のページを読み取れます。タスクが queued、running、failed の間は、エンドポイントは results を含まないタスクのメタデータを返します。
送信のボディに任意の callback_url を指定すると、タスクの完了時にSocQがタスクの概要を1回POSTで送信します。レコードは GET /v1/tasks/{task_id} で読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、重複して料金を払うことのないよう、同じタスクIDで再開してください。402 はクレジット不足、429 はキーがレート制限またはクレジットの上限に達したことを意味します。
Google Hotels API:目的地を検索する
Google Hotels APIは、旅行者がGoogleで探すのと同じ方法でホテルを検索します。query に目的地またはホテルの検索語を指定します。
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
}'
任意のフィールド:
check_inとcheck_out(YYYY-MM-DD、両方をあわせて指定し、最大30泊)で、特定の滞在の料金を取得します。指定しない場合は、明日からの1泊の料金になります。currency:USDやEURなどの3文字のコード。sort_by:relevance、lowest_price、highest_rating、most_reviewedのいずれか。min_priceとmax_price:選択した通貨での1泊あたりの料金の範囲。location_code(デフォルトは2840、米国)とlanguage_code(デフォルトはen)。results_limit:1から140、デフォルトは18。
各ホテルの行には、id、name、stars(1から5)、rating(1から5)、reviews_count、price(amount、currency、formatted)、料金の対象となる check_in と check_out、is_sponsored、緯度と経度を含む location、images、検索結果内の rank が含まれます。デフォルトの18件では2.7クレジット($0.0135)、上限の140件では21クレジット($0.105)です。ドキュメント:Google Hotels search。
Google Hotel Details API:1つの施設のすべての情報
Google Hotel Details APIは、Google Hotelsが持っている施設の情報を1行で返します。検索結果の id を hotel_id として渡します。check_in と check_out を追加するとその日程のオファーが取得でき、指定しない場合は明日からの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"
}'
詳細の行には、検索のフィールドに加えて次の内容が入ります。
address、phone、website、check_in_time、check_out_time、amenities。overall、things_to_do、restaurants、transit、airport_accessについての1から5のlocation_scores。rating_distribution:星の評価ごとの口コミの割合。review_topics:LocationやBreakfastなどのトピックと、肯定的・否定的・合計の言及数。other_reviews:ほかの口コミサイトでのホテルの評価と口コミ数。offers:予約サイトごとに1件で、seller、price、予約のurl、is_official、is_sponsored、free_cancellation_untilを含みます。
offers は、料金のパリティチェックに必要なデータです。同じ日程について、公式サイトのオファーとオンライン旅行代理店(OTA)のオファーを比較できます。各リクエストは2クレジット($0.01)です。存在しない hotel_id は行を返しませんが、課金はされます。ドキュメント:Google Hotel Details。
Hotel Price Tracker API:チェックイン日ごとの最安料金
Hotel Price Tracker APIは、Google Hotelsの日付選択の裏にある料金カレンダーを行として返します。1つのホテルについて、チェックインする夜ごとの最安料金が、通常はチェックイン日から6〜8週間分取得できます。
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"
}'
check_in はカレンダーの最初の日付を指定します(省略した場合は明日)。指定する場合は check_out もあわせて渡してください。各行には、ホテルIDと日付から作られる id、hotel_id、name、check_in、check_out、price が含まれます。最も安く泊まれる夜を見つけたり、週末と平日の料金をグラフにしたり、料金比較レポートのデータとして使ったりできます。各リクエストは、日付の数にかかわらず4クレジット($0.02)です。ドキュメント:Hotel Price Tracker。
競合セットを調べるシンプルなワークフロー
sort_by: "most_reviewed"で目的地を1回検索し、結果から競合セットを選びます。- 各ホテルのHotel Detailsを取得し、設備、立地スコア、口コミのトピック、予約サイトごとのオファーを比較します。
- 各ホテルについてHotel Price Trackerを定期的に実行し、すべての行を
collected_atとともに保存します。
デフォルトの18件の検索から選んだ10件のホテルの場合、1回の実行で検索に2.7クレジット、詳細に20クレジット、料金カレンダーに40クレジットかかり、合計62.7クレジット(約$0.31)です。料金は変動するため、各実行はその時点のスナップショットとして扱ってください。Googleマップ上の場所や口コミなどのローカルビジネスのデータについては、Googleマップスクレイパー APIをご覧ください。
よくある質問(FAQ)
Google Hotels APIとは何ですか?
Google Hotelsのデータを構造化された行として返すSocQのエンドポイント群で、目的地の検索結果、1件のホテルの詳細、1泊ごとの料金カレンダーを取得できます。これらはSocQのエンドポイントであり、Googleの公式製品ではありません。
hotel_idはどこで取得できますか?
Google Hotelsの検索結果の id フィールドから取得します。同じ値をHotel DetailsとHotel Price Trackerの両方で使えます。
料金はどの日程のものですか?
check_in と check_out(YYYY-MM-DD、最大30泊)を送信した場合は、その滞在の料金です。指定しない場合、検索と詳細は明日からの1泊の料金になり、料金トラッカーは明日からカレンダーを開始します。
別の通貨で料金を取得できますか?
はい。EUR などの3文字の currency を送信してください。すべての料金オブジェクトには、amount、currency、そして USD 176 のような formatted の文字列が含まれます。
無効なhotel_idにも課金されますか?
はい。Hotel Detailsは存在しない hotel_id に対して行を返しませんが、2クレジットが課金されます。そのため、事前に最近の検索結果とIDを照合してください。
GOOGLE HOTELS API
公開Google HotelsのURLでワークフローを試す
公開データの入力を送信すると、取得元をたどれるコンテキスト付きの正規化レコードを受け取れます。
Google HotelsのAPIを見る