✈ HKIA Flights API

香港國際機場航班資訊 JSON API · 供 AI Agent 及開發者使用

Endpoints

GET /api/flights 推薦 AI 使用

回傳指定日期的航班資料（JSON 格式）。AI Agent 可直接 web_fetch 此 endpoint，無需爬 HTML。

Query Parameters

參數類型預設值說明
datestring今日日期，格式 YYYY-MM-DD（香港時間）
typestringarrivalarrival（抵港）或 departure（離港）
searchstring（無）按航班號過濾，不區分大小寫，支援部分匹配。例如 search=CX949 只返回 CX 949，search=CX 返回所有 CX 航班。空格會自動忽略（CX 949 等同 CX949）。AI 推薦

範例請求

GET /api/flights?date=2026-03-23&type=arrival
GET /api/flights?date=2026-03-23&type=arrival&search=CX949   ← AI 精準搜尋單一航班
GET /api/flights?date=2026-03-23&type=arrival&search=CX      ← 搜尋所有 CX 航班
GET /api/flights?date=2026-03-23&type=departure
GET /api/flights  (不帶參數，預設今日抵港)
▶ 試試看（今日抵港） ▶ 試試看（搜尋 CX949） ▶ 試試看（今日離港）

Response Schema

"date": "2026-03-23",          // 查詢日期
"type": "arrival",           // arrival | departure
"count": 436,                 // 航班總數
"fetchedAt": "2026-03-23T10:00:00.000Z",  // 本次請求時間 (UTC)
"lastUpdatedTime": "2026-03-23T10:02:42+08:00",  // 機管局資料更新時間
"flights": [
  {
    "time": "08:30",           // 原定時間（HH:MM，香港時間）
    "flightNo": "CX 776",    // 航班號（可能包含代碼共享，以 / 分隔）
    "airline": "CPA",        // IATA 航空公司代碼
    "origin": "CGK",         // 出發地 IATA 機場代碼（抵港）/ 目的地（離港）
    "status": "Est at 20:18", // 原始狀態字串（見下方說明）
    "terminal": "1",         // 航廈（T1 / T2，可能為空）
    "hall": "B",             // 大堂（A / B，抵港）
    "baggage": "14"          // 行李轉盤號（可能為空）
  }
]

Status 欄位說明

原始值（status）含義
At gate HH:MM已抵達登機閘口
Arrived已抵達
Baggage at belt N行李已到 N 號轉盤
Landed已降落
Est at HH:MM飛行中，預計 HH:MM 抵達（可能延誤）
En route飛行中
Delay HH:MM延誤，預計 HH:MM
Cancelled取消
Scheduled預定（未起飛）
（空字串）預定（未起飛）
給 AI Agent 的提示： 若要判斷航班是否延誤，比較 time（原定時間）和 status 中的 Est at HH:MM 時間。若預計時間比原定時間遲，即為延誤。若 status 已過 10 分鐘仍顯示 Est at，航班可能已落地但 API 未更新。

快取與更新頻率

本 API 每 2 分鐘從機管局重新抓取資料（stale-while-revalidate）。機管局 API 本身每數分鐘更新一次。建議 AI Agent 每 2-5 分鐘查詢一次即可，無需更頻繁。

AI Agent 使用範例

# 查詢今日抵港航班
web_fetch("https://flight.omw.taxi/api/flights?date=2026-03-23&type=arrival")

# 查詢特定日期離港航班
web_fetch("https://flight.omw.taxi/api/flights?date=2026-03-25&type=departure")

# 不帶參數（預設今日抵港）
web_fetch("https://flight.omw.taxi/api/flights")