ignav

Ignav API を使用したフライト検索

https://ignav.com で利用できる高速な REST API によるフライト検索です。価格、旅程、予約リンクを含む構造化 JSON を返します。無料リクエストは 1,000 回で、レート制限はありません。

セットアップ

https://ignav.com/signup で無料の API キーを取得します（リクエスト 1,000 回、クレジットカード不要）。

環境または .env ファイルに IGNAV_API_KEY を設定します。

ワークフロー

1. ユーザーのリクエストを解析します（出発地、目的地、日付、旅行の種類、乗客、座席クラス）
2. ユーザーが都市名を指定した場合は、空港コードを調べます
3. フライトを検索します（片道または往復）
4. 結果を Markdown テーブルで提示します
5. ユーザーが予約を希望する場合は、予約リンクを取得します

エンドポイント

空港を検索

curl -s "https://ignav.com/api/airports?q=Barcelona&limit=5" \
  -H "X-Api-Key: $IGNAV_API_KEY"

片道フライト

curl -s -X POST "https://ignav.com/api/fares/one-way" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "destination": "JFK",
    "departure_date": "2026-05-15",
    "adults": 1,
    "cabin_class": "economy"
  }'

往復フライト

curl -s -X POST "https://ignav.com/api/fares/round-trip" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "destination": "JFK",
    "departure_date": "2026-05-15",
    "return_date": "2026-05-20",
    "adults": 1,
    "cabin_class": "economy"
  }'

予約リンク

curl -s -X POST "https://ignav.com/api/fares/booking-links" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ignav_id": "the_itinerary_id", "adults": 1}'

パラメーター

パラメーター	型	説明
adults	int	大人の人数（デフォルト：1）
children	int	子どもの人数（デフォルト：0）
cabin_class	string	economy、premium_economy、business、first
max_stops	int	0（直行便のみ）、1、または 2
max_price	int	最高価格のフィルター
departure_time_range	object	{"earliest_hour": 8, "latest_hour": 20}
airlines_include	array	これらの航空会社コードのみを対象にします
airlines_exclude	array	これらの航空会社コードを除外します
market	string	価格設定に使用する国コード（デフォルト："US"）。市場が異なると、価格も異なります。

レスポンスの構造

各旅程には以下が含まれます：

• price：{"amount": 299, "currency": "USD"}
• outbound：航空会社、所要時間（分）、区間の配列
• inbound：同上（片道の場合は null）
• cabin_class：座席クラス
• bags：{"carry_on": 1, "checked": 0}
• ignav_id：予約リンク用の一意の ID

各区間：marketing_carrier_code、flight_number、departure_airport、departure_time_local、arrival_airport、arrival_time_local、duration_minutes、aircraft。

出力形式

常に Markdown テーブルを使用してください。

#	航空会社	経由地	所要時間	出発	到着	価格	手荷物
1	Vueling	直行	2h 15m	8:30 AM	10:45 AM	EUR 125	機内持ち込み手荷物 1 個
2	Ryanair	直行	2h 20m	6:15 AM	8:35 AM	EUR 89	機内持ち込み手荷物 1 個

テーブルの後に、最安、最速、最もお得な選択肢を強調します。トレードオフを説明し、予約リンクを提示します。

注意事項

• すべての検索で日付が必要です
• 指定がない場合は、往復便とエコノミークラスをデフォルトにします
• 都市名から空港を調べる場合は、空港検索エンドポイントを使用します
• 市場によって価格が変わります。 同じ路線でも、別の市場から検索すると大幅に安くなる場合があります。まず出発国、次に目的地の国を試してください。
• Southwest は含まれません。 SW には google-flights skill を使用してください。