google-hotels

🏨 Google Hotels API：ホテル料金と施設データを整理された JSON で取得

Google Hotels API を利用する、最も効率的で信頼性が高く、開発者に優しい方法です。

アクターページ： apify.com/johnvc/google-hotels-search-scraper 入力スキーマ： apify.com/johnvc/google-hotels-search-scraper/input-schema

Google Hotels を検索して、整理された構造の JSON を返します。宿泊施設とバケーションレンタルの掲載情報には、1 泊あたりの料金と合計料金、割引、星のクラスと施設タイプ、評価とレビュー数、アメニティ、画像、説明、住所と GPS 座標、チェックイン／チェックアウト時刻が含まれます。場所のクエリで検索するか、トークンを使って 1 件の施設を取得できます。高度なフィルター、バケーションレンタル、ローカライズ（国、言語、通貨）、複数ページのページネーションに対応しています。

新機能： search_type 入力で、さらに 3 つのモードを利用できます。autocomplete（目的地とホテル名の候補を施設トークン付きで取得）、photos（施設の全写真ギャラリー）、reviews（評価、テキスト、出典を含むページ分割された宿泊客レビュー）です。それぞれに、このリポジトリ内で実行できるサンプルスクリプトがあります。

動画による解説

クイックスタート

前提条件

• Python 3.11 以降
• Apify アカウントと API キー (こちらから無料キーを取得)

1. リポジトリをクローンする

   git clone https://github.com/johnisanerd/Apify-Google-Hotels-API.git
   cd Apify-Google-Hotels-API
   

2. UV で依存関係をインストールする

   # Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies:
   uv sync
   

3. API キーを設定する

   cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3
   

4. サンプルを実行する

   uv run python google-hotels-api.py            # hotel search (the classic quick start)
   uv run python google-hotels-autocomplete.py   # destination + hotel name suggestions
   uv run python google-hotels-photos.py         # full photo gallery for one hotel
   uv run python google-hotels-reviews.py        # guest reviews for one hotel
   

代替方法：API キーを直接設定する

export APIFY_API_TOKEN="your_api_key_here"
uv run python google-hotels-api.py

この Google Hotels API を使う理由

豊富な施設データ。 各結果には、1 泊あたりの料金と合計料金、割引、評価とレビュー数、アメニティ、画像、説明、GPS 座標、チェックイン／チェックアウト時刻が含まれるため、施設を直接比較できます。

4 つの取得モード。 場所のクエリで検索する、property_token を使って 1 件の施設の詳細をすべて取得する、オートコンプリートで不完全なクエリから目的地やホテルを特定する、または施設の写真ギャラリーと宿泊客レビューをすべて取得できます。

強力なフィルター。 料金範囲、星のクラス、宿泊客の評価、アメニティ、施設タイプで絞り込み、寝室数とバスルーム数のフィルターを使ってバケーションレンタルに切り替えられます。

予測しやすい従量課金制の料金。 実行ごと、および処理したページごとの料金で、サブスクリプションはありません。ページ上限でコストを管理できます。

自動化が簡単。 Python から数行で呼び出すか、MCP ツールとして読み込めば、Claude や Cursor などのアシスタントが必要に応じてホテルを検索できます。

機能

主な機能

• 場所クエリでの検索、またはトークンによる単一施設の検索
• オートコンプリート候補：不完全なクエリに対応し、連携に使える施設トークンを取得
• 写真ギャラリー：フルサイズ画像とサムネイルの URL をセクションごとに整理
• 宿泊客レビュー：評価、テキスト、日付、出典、並べ替えオプションを含む
• ローカライズ：国、言語、通貨に対応
• 高度なフィルター：料金範囲、星のクラス、宿泊客の評価、アメニティ、施設タイプ
• バケーションレンタルモード：寝室数とバスルーム数のフィルターに対応
• 複数ページのページネーション：ページ上限を設定可能

データ品質

• 1 泊あたりの料金と合計料金：税引前の金額と割引フラグを含む
• 評価、レビュー、アメニティ、画像：施設ごとに取得
• GPS 座標と住所：地図表示に利用可能
• 一貫した JSON 形式：すべてのクエリで共通
• ページごとのデータセット項目：正確な課金を実現

使用例

基本的な検索

{
  "q": "hotels in Paris",
  "check_in_date": "2026-06-29",
  "check_out_date": "2026-07-01",
  "adults": 2,
  "max_pages": 1
}

フィルターを使った検索

{
  "q": "hotels in New York",
  "check_in_date": "2026-06-29",
  "check_out_date": "2026-07-01",
  "adults": 2,
  "min_price": "100",
  "max_price": "300",
  "hotel_class": "4,5",
  "currency": "USD",
  "max_pages": 1
}

バケーションレンタル

{
  "q": "vacation rentals in Miami",
  "check_in_date": "2026-06-29",
  "check_out_date": "2026-07-03",
  "adults": 4,
  "vacation_rentals": true,
  "bedrooms": 2,
  "bathrooms": 2,
  "max_pages": 1
}

オートコンプリート候補（google-hotels-autocomplete.py を参照）

{
  "search_type": "autocomplete",
  "q": "hotels in par",
  "gl": "us",
  "hl": "en"
}

候補ごとにデータセット項目を 1 件返します。特定のホテルの候補には property_token が含まれており、写真、レビュー、または施設の詳細の取得に利用できます。

宿泊施設の写真（google-hotels-photos.pyを参照）

{
  "search_type": "photos",
  "property_token": "ChUIksaK9_ij5_kYGgkvbS8wNjJ3YzIQAQ",
  "max_pages": 1
}

写真ごとに1つのデータセット項目を返します（通常、宿泊施設ごとに100～200枚）。項目にはphoto_url、thumbnail_url、寸法、ギャラリーのセクション、ソースが含まれます。

ゲストのレビュー（google-hotels-reviews.pyを参照）

{
  "search_type": "reviews",
  "property_token": "ChUIksaK9_ij5_kYGgkvbS8wNjJ3YzIQAQ",
  "reviews_sort_by": "2",
  "max_pages": 2
}

レビューごとに1つのデータセット項目を返します。評価、本文、日付、ソースプラットフォーム、レビュアーの詳細、宿泊施設からの返信（ある場合）が含まれます。reviews_sort_byで並べ替えます。"1"は参考になった順、"2"は新しい順、"3"は高評価順、"4"は低評価順です。

入力パラメーター

q（検索クエリ）またはproperty_tokenのいずれかが必要です。

パラメーター	型	必須	デフォルト	説明
search_type	string	いいえ	search	search、autocomplete、photos、reviewsのいずれかです。
q	string	はい*	-	検索クエリです。例：hotels in Paris。search（property_tokenが設定されている場合を除く）およびautocompleteで必須です。
property_token	string	はい*	-	単一の宿泊施設を示すトークンです（以前の検索結果またはオートコンプリートから取得）。photosとreviewsで必須です。searchモードでは宿泊施設の詳細情報を返します。
gl	string	いいえ	us	国コード（ISO 3166-1 alpha-2）です。
hl	string	いいえ	en	言語コード（ISO 639-1）です。
currency	string	いいえ	（国に基づく）	通貨コード（ISO 4217）です。例：USD、EUR。
check_in_date	string	いいえ	-	チェックイン日です。形式はYYYY-MM-DDです（クエリと併せて指定することを推奨します）。
check_out_date	string	いいえ	-	チェックアウト日です。形式はYYYY-MM-DDです。
adults	integer	いいえ	2	大人の宿泊人数です。
children	integer	いいえ	0	子どもの宿泊人数です（1人以上の場合はchildren_agesが必要です）。
min_price / max_price	string	いいえ	0.00	選択した通貨での価格帯フィルターです。
stars	string	いいえ	-	コンマ区切りの星評価です。例：4,5。
hotel_class	string	いいえ	-	コンマ区切りのクラスレベル2～5です。
guest_rating	string	いいえ	0.0	ゲスト評価の最低値です（0.0～5.0）。
vacation_rentals	boolean	いいえ	false	バケーションレンタルを含めます（bedrooms／bathroomsが有効になります）。
reviews_sort_by	string	いいえ	1	レビューの並び順です。1は参考になった順、2は新しい順、3は高評価順、4は低評価順です。
reviews_category_token	string	いいえ	-	宿泊施設のレビュー内訳にあるカテゴリートークンを使ってレビューを絞り込みます。
max_pages	integer	いいえ	1	取得するページの最大数です（0＝上限なし）。検索、写真、レビューに適用されます。
output_file	string	いいえ	-	結果を保存するファイル名（任意）です。

追加のフィルター（amenities、property_type、rental_type）にはGoogleの整数IDを指定します。完全なリファレンスはActorのページを参照してください。

出力形式

hotels in Parisの実際の結果です（ページごとに1項目。見やすさのため、properties配列は1件に絞っています）。

{
  "search_parameters": {
    "q": "hotels in Paris",
    "gl": "us",
    "hl": "en",
    "currency": "USD",
    "check_in_date": "2026-06-29",
    "check_out_date": "2026-07-01",
    "adults": 2,
    "max_pages": 1
  },
  "search_metadata": {
    "total_results": 15000,
    "properties_count": 20,
    "ads_count": 0,
    "pages_processed": 1,
    "max_pages_set": 1,
    "pagination_limit_reached": true
  },
  "page_number": 1,
  "properties": [
    {
      "type": "hotel",
      "name": "The Originals Boutique, Hôtel Maison Montmartre, Paris",
      "description": "Hip hotel featuring a sophisticated restaurant & a cool rooftop eatery/bar with a terrace.",
      "link": "https://www.hotelmaisonmontmartre.com/",
      "property_token": "ChoI_uTZsvz1i6-bARoNL2cvMTFmZHB6eDEwMxAB",
      "gps_coordinates": { "latitude": 48.900537, "longitude": 2.336269 },
      "check_in_time": "3:00 PM",
      "check_out_time": "12:00 PM",
      "rate_per_night": { "lowest": "$144", "extracted_lowest": 144, "before_taxes_fees": "$120" },
      "total_rate": { "lowest": "$287", "extracted_lowest": 287 }
    }
  ],
  "ads": [],
  "filters": [],
  "refine_by": []
}

---

n8nとの連携

n8nコミュニティノードとして利用できます。n8n-nodes-google-hotels-api。n8nで「Settings」→「Community Nodes」の順に選択し、n8n-nodes-google-hotels-apiをインストールしてから、任意のワークフローで使用してください（AIエージェントのツールとしても機能します）。バージョン0.2.0では、「Get Autocomplete Suggestions」、「Get Photos」、「Get Reviews」の各操作が追加されました。

MCPツールとして使用する

Google Hotels APIをMCPツールとして読み込むと、アシスタントが代わりに呼び出せます。MCPサーバーのURLには、このActorのみが事前に読み込まれます。

https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper

ブラウザーでOAuth認証するか、Apify APIトークン（Pythonの例で使用しているものと同じAPIFY_API_TOKEN）で認証してください。トークンはhttps://console.apify.com/settings/integrations で取得できます。無料のApifyアカウントはhttps://apify.com?fpr=9n7kx3 から作成できます。

Claude Cowork Desktop にインストールする

Cowork はデスクトップアプリの自動化モードです。Google Hotels API をツールとして使えるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、Settings → Connectors に移動します（または Settings → Developer → Edit Config を選択して、claude_desktop_config.json を直接編集します）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. この Actor のみを事前に読み込んだ Apify MCP サーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出すときに、ブラウザーで OAuth プロンプトを完了するか、OAuth を省略するため、コネクターの設定に Apify API トークンを追加します。
4. Cowork のチャットでツールが利用可能であることを確認し、Google Hotels API の実行を依頼します。

デスクトップアプリをダウンロードして、無料トライアルを開始します：https://claude.ai/referral/uIlpa7nPLg
詳細はこちら：https://docs.apify.com/platform/integrations/claude-desktop

Claude Code にインストールする

Claude Code はコマンドラインツールです。次のコマンドで Actor の MCP サーバーを追加します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper"

ブラウザー OAuth の代わりにトークンを使用するには、次を実行します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp list で確認するか、セッション内で /mcp を実行します。Google Hotels API の呼び出しを Claude Code に依頼します。

Claude Code を無料でお試しください：https://claude.ai/referral/uIlpa7nPLg
Claude Code の MCP ドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストールする

claude.ai では、Apify をコネクターとして追加し、この Actor のツールだけを有効にします。

1. Settings → Connectors → Browse connectors に移動し、Apify MCP server を検索します。インストールします（有効化または更新を求められた場合は、その指示に従います）。
2. 接続時に Apify API トークンで認証し、ツール johnvc/google-hotels-search-scraper を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択して、完全な MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper を貼り付けます。プロンプトが表示されたら OAuth を使用します。
5. Google Hotels API の実行を Claude に依頼します。

ウェブで Claude を開く：https://claude.ai/referral/uIlpa7nPLg

Cursor にインストールする

Cursor は、プロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper"
    }
  }
}

2. ブラウザー OAuth の代わりにトークン認証を使う場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Google Hotels API の呼び出しを Cursor に依頼します。

Cursor を初めて使う方はこちら：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT にインストールする

ChatGPT は Developer mode を通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education プランで利用できます）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開き、Developer mode を有効にします。
2. Create app をクリックし、フォームに入力します。
   • Name: Apify
   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/google-hotels-search-scraper
   • Authentication: OAuth
3. Create をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャットで + をクリックし、Developer mode を選択して、Apify を選びます。

詳しくはこちら：https://docs.apify.com/platform/integrations/mcp

---

心を込めて制作

Google Hotels API を使って、信頼性の高い構造化された結果を取得し、価格モニタリング、旅行アプリ、市場調査に役立てましょう。

🤖 この Actor について AI アシスタントに質問する

お好みの AI で Google Hotels API について質問できる、すぐに送信可能なプロンプトを開きましょう。

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

最終更新日：2026.10.27