google-flights

✈️ Google Flights API：フライトと価格をクリーンな JSON で検索

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

Actor ページ： apify.com/johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search 入力スキーマ： apify.com/johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search/input-schema

Google Flights API はフライトを検索し、整然と構造化された JSON を返します。結果の各ページには、おすすめのフライトと代替便、全フライト区間と所要時間、価格、価格分析（価格水準と過去の価格帯）、空港の詳細、検索メタデータが含まれます。片道、往復、複数都市の旅程、単一または複数の空港に対応し、価格、経由回数、航空会社、搭乗者数で絞り込めます。また、航空会社や OTA の直接予約リンクを任意で取得できます。29 以上の言語、39 以上の国に対応しています。

動画での解説

クイックスタート

前提条件

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

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

   git clone https://github.com/johnisanerd/Apify-Google-Flights-API.git
   cd Apify-Google-Flights-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-flights-api.py
   

このリポジトリには、fetch_booking_options を有効にして航空会社や OTA の直接予約リンクを取得する、低コストの片道サンプル（BOS から PQI）google-flights-get-booking-options.py も含まれています。

uv run python google-flights-get-booking-options.py

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

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

この Google Flights API を使う理由

旅程全体を取得。 片道、往復、複数都市の旅行を検索できます。出発空港と到着空港をそれぞれ単一または複数指定でき、フライト区間ごとの詳細とともに、おすすめのフライトや代替便を取得できます。

直接予約リンク。 fetch_booking_options を有効にすると、各フライトについて、運賃種別や手荷物料金を含む航空会社または OTA サイトの有効な予約 URL を取得でき、アプリにそのまま組み込めます。

強力なフィルター。 最高価格、経由回数の上限、優先する航空会社、搭乗者数を指定でき、ベーシックエコノミーを除外できます。

価格情報。 検索するたびに価格分析が返されます。現在の価格水準（安い、標準、高い）と、路線の過去の価格帯を確認できます。

わかりやすい従量課金。 課金対象は処理したページごとで、予約リンクを取得する場合にのみ、取得したリンクごとの料金が加算されます。サブスクリプションは不要です。ページ数の上限で費用を管理できます。

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

機能

主な機能

• 片道、往復、複数都市の旅程
• 各区間で単一または複数の空港を指定（例：CDG,ORY）
• 価格、経由回数、航空会社、搭乗者数、ベーシックエコノミーのフィルター
• 直接予約リンクを任意で取得（航空会社／OTA の URL、運賃種別、手荷物料金）
• 29 以上の言語、39 以上の国に対応したローカライズ

データ品質

• おすすめのフライトと代替便（各区間の所要時間、航空会社、飛行時間の詳細を含む）
• 価格水準と過去の価格帯を含む価格分析
• 出発空港と到着空港の詳細
• ページごとのメタデータと、検索パラメーターを応答に含めて返却
• すべての検索で一貫した JSON 形式

使用例

基本的な片道検索

{
  "departure_id": "LAX",
  "arrival_id": "JFK",
  "outbound_date": "2026-10-12",
  "adults": 1,
  "currency": "USD",
  "max_pages": 1
}

フィルターを使った往復検索

{
  "departure_id": "JFK",
  "arrival_id": "LHR",
  "outbound_date": "2026-11-25",
  "return_date": "2026-12-02",
  "adults": 2,
  "max_price": 1500,
  "max_stops": 1,
  "max_pages": 2
}

複数都市の旅行

{
  "multi_city_json": "[{\"departure_id\":\"CDG\",\"arrival_id\":\"NRT\",\"date\":\"2026-11-17\"},{\"departure_id\":\"NRT\",\"arrival_id\":\"LAX\",\"date\":\"2026-11-24\"}]",
  "adults": 1,
  "currency": "USD",
  "max_pages": 1
}

直接予約リンク

{
  "departure_id": "LAX",
  "arrival_id": "JFK",
  "outbound_date": "2026-10-12",
  "adults": 1,
  "fetch_booking_options": true,
  "max_pages": 1
}

注：fetch_booking_options は片道検索で動作し、リンクの取得ごとに課金されます。また、Actor のメモリが 512 MB 以上必要です（ヘッドレスブラウザーを使用します）。

入力パラメーター

departure_id ＋ arrival_id ＋ outbound_date、または multi_city_json が必要です。

パラメーター	型	必須	デフォルト	説明
departure_id	string	はい*	-	出発空港コード。複数指定する場合はカンマ区切りです（例：LAX、CDG,ORY）。
arrival_id	string	はい*	-	到着空港コード。複数指定する場合はカンマ区切りです。
outbound_date	string	はい*	-	出発日。YYYY-MM-DD 形式です。
return_date	string	いいえ	(なし)	往復旅行の帰着日。YYYY-MM-DD 形式です。
multi_city_json	string	はい*	-	複数都市への旅行の区間を記述した JSON 文字列です。上記の 3 つのフィールドの代わりに指定します。
adults	integer	いいえ	1	大人の乗客数（最小 1 人）。
children	integer	いいえ	0	子どもの乗客数です。
infants	integer	いいえ	0	乳幼児の乗客数です。
currency	string	いいえ	USD	通貨コード。例：USD、EUR、GBP。
hl	string	いいえ	en	言語コード（29 以上に対応）。
gl	string	いいえ	us	国コード（39 以上に対応）。
max_price	integer	いいえ	(なし)	選択した通貨での最高価格フィルターです。
max_stops	integer	いいえ	(なし)	経由地の最大数（0 ＝直行便のみ）。
airlines	string	いいえ	(なし)	優先する航空会社コードをカンマ区切りで指定します。例：UA,AA,DL。
exclude_basic	boolean	いいえ	false	ベーシックエコノミー運賃を除外します。
fetch_booking_options	boolean	いいえ	false	直接予約リンクを取得します（片道のみ。リンクごとに課金され、512 MB 以上が必要です）。
max_pages	integer	いいえ	1	取得するページの最大数（0 ＝無制限）。
output_file	string	いいえ	(なし)	結果を保存する任意のファイル名です。

出力形式

LAX から JFK への実際の結果です（ページごとに 1 項目。ここでは読みやすさのため、best_flights の区間と price_insights の履歴を省略しています）。

{
  "search_parameters": {
    "trip_type_description": "One-way",
    "departure_id": "LAX",
    "arrival_id": "JFK",
    "outbound_date": "2026-10-12",
    "adults": 1,
    "currency": "USD",
    "language": "en",
    "country": "us"
  },
  "search_metadata": {
    "total_flights_found": 29,
    "best_flights_count": 3,
    "other_flights_count": 26,
    "pages_processed": 1,
    "pagination_limit_reached": true,
    "booking_options_count": 0
  },
  "page_number": 1,
  "best_flights": [
    {
      "price": 207,
      "type": "One way",
      "total_duration": 590,
      "flights": [
        {
          "departure_airport": { "name": "Los Angeles International Airport", "id": "LAX", "time": "2026-10-12 09:24" },
          "arrival_airport": { "name": "Charlotte Douglas International Airport", "id": "CLT", "time": "2026-10-12 17:28" },
          "airline": "American",
          "flight_number": "AA 2570",
          "travel_class": "Economy",
          "duration": 304
        },
        {
          "departure_airport": { "name": "Charlotte Douglas International Airport", "id": "CLT", "time": "2026-10-12 20:11" },
          "arrival_airport": { "name": "John F. Kennedy International Airport", "id": "JFK", "time": "2026-10-12 22:14" },
          "airline": "American",
          "flight_number": "AA 1727",
          "travel_class": "Economy",
          "duration": 123
        }
      ]
    }
  ],
  "other_flights": [],
  "price_insights": {
    "lowest_price": 207,
    "price_level": "typical",
    "typical_price_range": [145, 255]
  },
  "airports": [
    {
      "departure": [
        { "airport": { "id": "LAX", "name": "Los Angeles International Airport" }, "city": "Los Angeles", "country": "United States" }
      ],
      "arrival": [
        { "airport": { "id": "JFK", "name": "John F. Kennedy International Airport" }, "city": "New York", "country": "United States" }
      ]
    }
  ],
  "booking_options": []
}

fetch_booking_options が true の場合、各 booking_options エントリーには、航空会社または OTA の解決済み booking_url と、運賃ファミリーおよび手荷物の詳細が含まれます。

---

MCP ツールとして使用する

Google Flights API を MCP ツールとして読み込み、アシスタントに呼び出させることができます。MCP サーバー URL には、この Actor のみがあらかじめ読み込まれています。

https://mcp.apify.com/?tools=actors,docs,johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search

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

Claude Cowork デスクトップにインストールする

Cowork はデスクトップアプリの自動化モードです。Google Flights 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-Flights-Data-Scraper-Flight-and-Price-Search"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出す際に、ブラウザーで OAuth プロンプトを完了するか、コネクターの設定に Apify API トークンを追加して OAuth を省略します。
4. Cowork のチャットでツールが利用可能であることを確認し、Google Flights 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-Flights-Data-Scraper-Flight-and-Price-Search"

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

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp list を実行して確認するか、セッション内で /mcp を実行します。Google Flights 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-Flights-Data-Scraper-Flight-and-Price-Search を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択し、MCP の URL 全体 https://mcp.apify.com/?tools=actors,docs,johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search を貼り付けます。求められたら OAuth を使用します。
5. Google Flights 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-Flights-Data-Scraper-Flight-and-Price-Search"
    }
  }
}

2. ブラウザー OAuth ではなくトークン認証を使用する場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Google Flights 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-Flights-Data-Scraper-Flight-and-Price-Search
   • Authentication： OAuth
3. Create をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャット内の + をクリックし、Developer mode を選択して、Apify を選びます。

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

---

心を込めて作成

信頼性の高い構造化された結果を活用して、旅行アプリ、運賃の追跡、分析を支える Google Flights API を使用できます。

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

Google Flights API について、すぐに送信できるプロンプトをお好みの AI で開きます。

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

最終更新日：2026.10.27