本文へスキップ
言語 — 現在: 日本語
テーマ — 現在: システムに合わせる

Google Flights Calendar

engine=google_flights_calendar

Google Travel の結果を構造化 JSON で返します。すべてのエンジンが応答するのと同じエンドポイントからです。

リクエスト

GET
リセット

パラメータ

このパラメータを送信 キー 値 説明
認証
api_key必須

SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.

これは作者自身の SearchApi キーです。登録なしでこのページを実際に実行できるよう、意図的に置いてあります。ご自身のアカウントで実行するには、自分のキーに置き換えてください — この行にあるキーが「ライブ実行」でクレジットを消費するキーであり、上のアドレスとすべてのコードサンプルが運ぶキーでもあります。したがって、ここに貼り付けたキーは共有したリンクにも入ります。隣の「実行」は記録から応答し、何も消費しません。

api_key_preset
既定

どのデモキーを送るか。動作するキーは記録済みサンプルを、他の 2 つは記録済みの 401 と 429 のエンベロープを返します。エラー状態への道筋が、呼び出す側の実際の道筋になります。
必須
departure_id必須

Departure airport IATA code or location kgmid.
arrival_id必須

Arrival airport IATA code or location kgmid.
outbound_date必須

Base outbound date the price calendar is built around (YYYY-MM-DD).
ターゲティング 送信されるのはあなたが設定したものだけです。API 自身の既定値を送り返せば、選んでもいない十数個のパラメータが送られ、選んだものが埋もれてしまいます。
gl
既定

Country of the search (two-letter country code).
hl
既定

Interface language of the search (two-letter language code).
currency
既定

Currency of the returned prices (ISO 4217 code).
その他 このエンジンが受け付ける残りすべてを、カタログの順で。
return_date

Base return date for round trips (YYYY-MM-DD).

JSON

まだ何も実行されていません。リクエストを送信すると記録済みレスポンスが表示されます。

「実行」はディスクから返す記録に応答します。実際に API を呼ぶには、下の「ライブ実行」に自分のキーを貼り付けてください。

コード

cURL 
curl "https://www.searchapi.io/api/v1/search?engine=google_flights_calendar&departure_id=sample_google_flights_calendar_departure_id&arrival_id=sample_google_flights_calendar_arrival_id&outbound_date=2026-09-01&api_key=E5oa7LbhkKN7YUyj4CwXppK8"

送信されるのは必須パラメータとあなたが設定したパラメータだけです — リクエストが API 自身の既定値を API に送り返すことはありません。

エージェントから使う

カタログのすべてのエンジンは、すでに開いているエージェントから利用できます。一度接続すれば、あとは言葉で尋ねるだけです。

接続する

claude mcp add searchapi "<YOUR_MCP_URL>" --transport http

https://www.searchapi.io/integrations/mcp で MCP URL を作成し、プレースホルダーに上書きしてください。接続フローは OAuth なので、API キーがクライアントの設定に入ることはありません。

尋ねる

SearchApi の Google Flights Calendar エンジンでこの検索を実行し、結果を要約してください: departure_id = "sample_google_flights_calendar_departure_id"、arrival_id = "sample_google_flights_calendar_arrival_id"、outbound_date = "2026-09-01"

上のリクエストに追随します — パラメータを変えれば、これも一緒に変わります。

呼び出す

どちらも上のフォームが組み立てるリクエストを記述しています。

SearchApi の MCP サーバーは 2026-08-11 に確認しました。Streamable HTTP によるリモート、80 以上のツール、OAuth 接続です。そのツール一覧がどのエンジンを含むかは、ここでは検証していません。

パラメータ

7 個のパラメータを、レンダリング時にカタログから読み出しています。

google_flights_calendar エンジンが受け付けるパラメータ
パラメータ 型 説明
departure_id必須 string

Departure airport IATA code or location kgmid.
arrival_id必須 string

Arrival airport IATA code or location kgmid.
outbound_date必須 string

Base outbound date the price calendar is built around (YYYY-MM-DD).
return_date string

Base return date for round trips (YYYY-MM-DD).
currency string

Currency of the returned prices (ISO 4217 code).

既定値: USD

gl enum

Country of the search (two-letter country code).

  • us (既定)
  • af
  • al
  • dz
  • as
  • ad
  • ao
  • ai
  • aq
  • ag
  • ar
  • am

他 227 件の値

hl enum

Interface language of the search (two-letter language code).

  • en (既定)
  • af
  • ak
  • sq
  • am
  • ar
  • hy
  • az
  • eu
  • be
  • bem
  • bn

他 134 件の値

どのリクエストにも含まれるもの

カタログのすべてのエンジンに共通するパラメータが 3 つあります。呼び出すエンジン、呼び出しを認証するキー、そしてエンタープライズ向けの保持設定です。

すべてのエンジンに共通するパラメータ
パラメータ 型 説明
engine必須 string

Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE keys).
api_key必須 string

SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.
zero_retention boolean

Enterprise-only: disables all logging and persistent storage of the search.

既定値: false