Google Hotels Data APIs
目的地でホテルを検索し、任意のホテルのGoogleホテル上のプロフィールと1泊料金カレンダーを取得します。3つはすべて同じホテルIDでつながります。
利用できるGoogle Hotels API
まず Google Hotels API でホテルとホテルIDを見つけ、Google Hotel Details API で1軒のプロフィールと料金を、Hotel Price Tracker API でチェックイン日ごとの料金を取得します。
取得できるGoogle Hotelsデータ
各行は1軒のホテルまたは1泊分を表し、料金は指定した通貨で返ります。ホテルIDが3つのAPIをつなぎます。
料金付きのホテル一覧
ホテル名、順位、指定日程の最安1泊料金、広告枠かどうか、Googleホテル上のページへのリンク。
評価と宿泊者の口コミ
星評価、1〜5の宿泊者平均評価、口コミ件数、星ごとの評価の割合、口コミの話題ごとの好意的・否定的な言及数。
予約サイトごとの料金
販売元ごとの1泊料金と予約リンク。ホテル公式サイト、広告枠、無料キャンセル可能な料金を区別できます。
立地と周辺エリア
住所、座標、エリア名、観光・アクティビティ、飲食店、交通、空港アクセスの1〜5の評価。
1泊料金カレンダー
1軒のホテルについて、チェックイン日ごとの最安料金。通常この先6〜8週間分です。
どのGoogle Hotels APIを使うか
3つのAPIは同じホテルIDを使うため、検索結果をそのまま詳細や料金カレンダーのリクエストに渡せます。
| API | 入力 | 取得できる内容 |
|---|---|---|
| Google Hotels API | query に目的地またはホテル名 | 最大140軒のホテル。1泊料金、星評価、宿泊者評価、口コミ件数、座標、ホテルID |
| Google Hotel Details API | hotel_id を1つ | 1行。連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金 |
| Hotel Price Tracker API | hotel_id を1つ | チェックイン日ごとに1行。その夜の最安料金、通常この先6〜8週間分 |
Google Hotels APIの仕組み
3つのAPIはすべて同じ非同期タスクの流れで動きます。
1. ホテルを探す
目的地を /v1/google-hotels/search に POST し、追いかけたいホテルの id を保存します。
2. 詳しく調べる
hotel_id を /v1/google-hotels/hotel-details に POST してプロフィールと料金を、/v1/google-hotels/hotel-prices に POST して料金カレンダーを取得します。
3. 結果を読む
status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items の行を読み取ります。
SocQ APIキーで認証し、目的地を送ります。返されたホテル1軒ごとに0.15クレジットかかります。
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}'
# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.itemsGoogle Hotels APIの主なユースケース
目的地の料金ベンチマーク
同じ日程で、都市ごとの1泊料金を星評価や宿泊者評価と合わせて比べます。
料金の整合性チェック
同じ宿泊について、ホテル公式料金とオンライン旅行会社の料金を比べます。
競合ホテルの監視
近隣ホテルの料金カレンダー、評価の分布、口コミの話題を並べて追跡します。
旅行コンテンツとホテルページ
住所、設備、チェックイン時刻、写真、周辺エリアの評価でホテルページを充実させます。
旅行計画
予約の前に、この先数週間で最も安いチェックイン日を探します。
リクエストのルールと料金
以下のルールは3つのGoogle Hotels APIに共通です。
- check_in と check_out は YYYY-MM-DD 形式で今日以降の日付をセットで指定し、最長30泊までです。どちらも省略すると明日から1泊の料金になります。
- currency に USD や EUR などの3文字コードを指定すると、リクエスト間で料金を比べやすくなります。
- Google Hotels API は1回で1〜140軒(既定は18軒)を返し、返されたホテル1軒ごとに0.15クレジットかかります。
- Google Hotel Details API は検索結果の hotel_id を使い、1リクエスト2クレジットです。
- Hotel Price Tracker API は hotel_id を使い、カレンダー全体で1リクエスト4クレジットです。
Google Hotels APIに関するよくある質問
Google Hotels APIとは何ですか?
Google Hotels API は、目的地でGoogleホテルを検索し、指定日程の1泊料金、星評価、宿泊者評価、口コミ件数、座標、後続のリクエストに使うホテルIDを返すAPIです。
どのGoogle Hotels APIが使えますか?
検索用の Google Hotels API、1軒のプロフィールと予約サイトごとの料金を返す Google Hotel Details API、チェックイン日ごとの料金を返す Hotel Price Tracker API です。
hotel_id はどこから取得しますか?
Google Hotels API の各行の id フィールドにホテルIDが入っています。その値を hotel_id として詳細APIや料金カレンダーAPIに渡します。
料金はどの日程のものですか?
検索と詳細は指定した check_in と check_out(最長30泊)、どちらも省略した場合は明日から1泊の料金です。料金カレンダーはチェックイン日ごとに1泊分を約6〜8週間分並べます。
Google Hotelsのリクエスト料金は?
検索は返されたホテル1軒ごとに0.15クレジット、ホテル詳細は1リクエスト2クレジット、料金カレンダーは1リクエスト4クレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Brand Monitoring API
ブランド、製品、トピックに言及したWebページを探し、ページごとに感情をスコア化し、Web全体での語られ方を要約します。
AI Search API
AI概要、ChatGPT、GoogleのAIモードが市場の質問にどう答えているかを追跡します。ブランドに触れた回答、可視性の高さ、引用されているドメインとページがわかります。
Instagram API
公開プロフィールを検索・照会し、フォロワーリストのレコード、フォロー関係、投稿、プロフィールがタグ付けされた投稿、ハッシュタグの検索結果、リール、文字起こし、コメント、アカウント数値、エンゲージメント指標、メディアのメタデータを、1つの非同期ワークフローで取得できます。
TikTok API
対応する公開TikTokプロフィール、個別動画のメタデータ、トップレベルコメント、動画の検索結果、指定したハッシュタグの動画を、正規化された1つの非同期ワークフローで取得できます。
YouTube API
対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。
Facebook API
公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。


