API一覧に戻る
Google Hotels データ

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 APIquery に目的地またはホテル名最大140軒のホテル。1泊料金、星評価、宿泊者評価、口コミ件数、座標、ホテルID
Google Hotel Details APIhotel_id を1つ1行。連絡先、設備、周辺エリアの評価、評価の分布、口コミの話題、予約サイトごとの料金
Hotel Price Tracker APIhotel_id を1つチェックイン日ごとに1行。その夜の最安料金、通常この先6〜8週間分

Google Hotels APIの仕組み

3つのAPIはすべて同じ非同期タスクの流れで動きます。

  1. 1. ホテルを探す

    目的地を /v1/google-hotels/search に POST し、追いかけたいホテルの id を保存します。

  2. 2. 詳しく調べる

    hotel_id を /v1/google-hotels/hotel-details に POST してプロフィールと料金を、/v1/google-hotels/hotel-prices に POST して料金カレンダーを取得します。

  3. 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.items

Google 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ページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。