航班查询

flight-queryGET

GEThttps://v1.apizero.cn/api/flight-query

概述

按出发地、目的地和出发日期查询航班，返回航空公司、航班号、起飞时间、降落时间、航程时长和参考票价。查到航班后按次计费，不设免费额度。 ## 查询内容提交出发地、目的地和出发日期后，返回该日可查到的航班。出发地和目的地使用 IATA 三字码，城市码和机场码都可以。北京可填 BJS，上海可填 SHA，广州可填 CAN。指定航班号时，请改填机场码。每条航班包含： - 航空公司代码和名称 - 航班号。中转航班会把各段航班号写在一起 - 是否为共享航班 - 机型 - 出发机场、到达机场及其名称 - 出发日期、出发时间、到达日期、到达时间 - 航程时长 - 航段数量。1 表示直飞，大于 1 表示需要中转 - 参考票价，单位为元中转航班另附各航段的航空公司、航班号、起降机场与时间、飞行时长。可用航段数量限制查询范围：不填或填 0 表示不限，1 表示只查直飞，2 表示最多一次中转，3 表示最多两次中转。查询范围包括国内主流航空公司，也包括主要国际航线。 ## 适用场景商务出行。查看航班时刻和参考票价，安排差旅行程。旅行规划。比较不同航班的衔接时间和参考票价，选定路线。抵达安排。按航班的计划到达时间准备接机。 ## 调用与计费必须携带 API Key。不提供匿名调用，也不提供每日免费次数。黄金会员、钻石会员和企业会员均不包含本接口的免费次数。支持 HTTP 和 HTTPS。查到至少一条航班时计费，单价 0.330 元。未查到航班时仍返回成功，航班列表为空，本次不计费。参数不正确，或本次未能完成查询时，同样不计费。调用频率： - 登录用户：每秒 5 次 - 黄金会员：每秒 10 次 - 钻石会员：每秒 20 次 - 企业会员：每秒 30 次 ## 调用包调用包按月计算。有效期 1 个月，期内可使用对应次数。次数越多，单次价格越低。期内次数用完后，继续调用按 0.330 元/次从余额扣除。 - 体验月卡：99 元，300 次，合 0.3300 元/次 - 基础月卡：299 元，1,000 次，合 0.2990 元/次 - 标准月卡：699 元，2,500 次，合 0.2796 元/次 - 专业月卡：1,500 元，6,000 次，合 0.2500 元/次 - 企业月卡：2,940 元，12,500 次，合 0.2352 元/次 - 旗舰月卡：9,999 元，45,000 次，合 0.2222 元/次时刻和参考票价用于安排行程。实际起飞、到达和票价，以承运人和出票渠道公布的信息为准。

调用约定

网关 · https://v1.apizero.cn
鉴权 · Authorization: Bearer <API Key>
回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。

/aidocs/flight-query/raw.md

打开 Markdown

鉴权

必须携带 API Key。无免费额度。查到航班按次 0.330 元；未查到、参数不正确或本次未能完成查询时不计费。登录QPS 5，黄金会员 10 次，钻石会员 20 次，企业会员 30 次。

获取 API Key：获取 API Key/account/keys

请求头

Authorizationstring必填

必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

Header	类型	必填	说明
Authorization	string	是	必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

请求参数

GET · QUERY STRING · https://v1.apizero.cn/api/flight-query?departure=BJS&arrival=SHA&departure_date=2026-11-02&flight_no=HO1254&max_segments=1

departurestring必填

出发地。IATA 城市码或机场码，3 位字母。例：北京 BJS，首都机场 PEK，大兴机场 PKX

例BJS

arrivalstring必填

目的地。IATA 城市码或机场码，3 位字母。例：上海 SHA，浦东机场 PVG，虹桥机场 SHA

例SHA

departure_datestring必填

出发日期，格式 yyyy-MM-dd

例2026-11-02

flight_nostring选填

航班号，2 到 10 位字母或数字。填写时，出发地和目的地请填机场码

例HO1254

max_segmentsint选填

航段上限。0 不限，1 仅直飞，2 最多一次中转，3 最多两次中转。不填视为不限

例1

参数	类型	必填	说明	示例
departure	string	是	出发地。IATA 城市码或机场码，3 位字母。例：北京 BJS，首都机场 PEK，大兴机场 PKX	BJS
arrival	string	是	目的地。IATA 城市码或机场码，3 位字母。例：上海 SHA，浦东机场 PVG，虹桥机场 SHA	SHA
departure_date	string	是	出发日期，格式 yyyy-MM-dd	2026-11-02
flight_no	string	否	航班号，2 到 10 位字母或数字。填写时，出发地和目的地请填机场码	HO1254
max_segments	int	否	航段上限。0 不限，1 仅直飞，2 最多一次中转，3 最多两次中转。不填视为不限	1

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

departurestring

本次查询的出发地代码

arrivalstring

本次查询的目的地代码

departure_datestring

出发日期

flight_nostring

仅当请求填写了航班号时返回

max_segmentsint

仅当请求填写了航段上限时返回

countint

本次返回的航班条数。示例只保留 1 条

flightsarray

航班列表。未查到时为空数组，且本次不计费

airlinestring

航空公司代码

airline_namestring

航空公司名称

flight_nostring

航班号。中转时可能包含多个航班号

is_code_sharebool

是否包含共享航班

equipmentstring

机型

departurestring

出发机场码

departure_namestring

出发机场名称

departure_datestring

出发日期

departure_timestring

出发时间

arrivalstring

到达机场码

arrival_namestring

到达机场名称

arrival_datestring

到达日期

arrival_timestring

到达时间

durationstring

航程时长，如 2h10m

transfer_numint

航段数量。1 为直飞，大于 1 为中转

ticket_pricenumber

参考票价，单位元。没有则为 null

segmentsarray

各航段。仅中转航班返回

airlinestring

该航段航空公司代码

airline_namestring

该航段航空公司名称

flight_nostring

该航段航班号

is_code_sharebool

该航段是否为共享航班

op_airlinestring

该航段实际承运航空公司代码

op_flight_nostring

该航段实际承运航班号

equipmentstring

该航段机型

departurestring

该航段出发机场码

departure_namestring

该航段出发机场名称

departure_datestring

该航段出发日期

departure_timestring

该航段出发时间

arrivalstring

该航段到达机场码

arrival_namestring

该航段到达机场名称

arrival_datestring

该航段到达日期

arrival_timestring

该航段到达时间

flight_timestring

该航段飞行时长

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

字段

类型

说明

departure

string

本次查询的出发地代码

arrival

string

本次查询的目的地代码

departure_date

string

出发日期

flight_no

string

仅当请求填写了航班号时返回

max_segments

int

仅当请求填写了航段上限时返回

count

int

本次返回的航班条数。示例只保留 1 条

flights

array

航班列表。未查到时为空数组，且本次不计费

airline

string

航空公司代码

airline_name

string

航空公司名称

flight_no

string

航班号。中转时可能包含多个航班号

is_code_share

bool

是否包含共享航班

equipment

string

机型

departure

string

出发机场码

departure_name

string

出发机场名称

departure_date

string

出发日期

departure_time

string

出发时间

arrival

string

到达机场码

arrival_name

string

到达机场名称

arrival_date

string

到达日期

arrival_time

string

到达时间

duration

string

航程时长，如 2h10m

transfer_num

int

航段数量。1 为直飞，大于 1 为中转

ticket_price

number

参考票价，单位元。没有则为 null

segments

array

各航段。仅中转航班返回

airline	string	该航段航空公司代码
airline_name	string	该航段航空公司名称
flight_no	string	该航段航班号
is_code_share	bool	该航段是否为共享航班
op_airline	string	该航段实际承运航空公司代码
op_flight_no	string	该航段实际承运航班号
equipment	string	该航段机型
departure	string	该航段出发机场码
departure_name	string	该航段出发机场名称
departure_date	string	该航段出发日期
departure_time	string	该航段出发时间
arrival	string	该航段到达机场码
arrival_name	string	该航段到达机场名称
arrival_date	string	该航段到达日期
arrival_time	string	该航段到达时间
flight_time	string	该航段飞行时长

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "departure": "PEK",
    "arrival": "PVG",
    "departure_date": "2025-06-18",
    "count": 1,
    "flights": [
      {
        "airline": "CA",
        "airline_name": "中国国际航空公司",
        "flight_no": "CA0953 | CA0916",
        "is_code_share": false,
        "equipment": "325",
        "departure": "PEK",
        "departure_name": "首都国际机场",
        "departure_date": "2025-06-18",
        "departure_time": "09:05",
        "arrival": "PVG",
        "arrival_name": "浦东国际机场",
        "arrival_date": "2025-06-18",
        "arrival_time": "17:05",
        "duration": "08h00m",
        "transfer_num": 2,
        "ticket_price": 15063,
        "segments": [
          {
            "airline": "CA",
            "airline_name": "中国国际航空公司",
            "flight_no": "CA0953",
            "is_code_share": false,
            "op_airline": "CA",
            "op_flight_no": "CA0953",
            "equipment": "738",
            "departure": "PEK",
            "departure_name": "首都国际机场",
            "departure_date": "2025-06-18",
            "departure_time": "09:05",
            "arrival": "FUK",
            "arrival_name": "福冈机场",
            "arrival_date": "2025-06-18",
            "arrival_time": "14:10",
            "flight_time": "04h05m"
          },
          {
            "airline": "CA",
            "airline_name": "中国国际航空公司",
            "flight_no": "CA0916",
            "is_code_share": false,
            "op_airline": "CA",
            "op_flight_no": "CA0916",
            "equipment": "321",
            "departure": "FUK",
            "departure_name": "福冈机场",
            "departure_date": "2025-06-18",
            "departure_time": "15:55",
            "arrival": "PVG",
            "arrival_name": "浦东国际机场",
            "arrival_date": "2025-06-18",
            "arrival_time": "17:05",
            "flight_time": "02h10m"
          }
        ]
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/flight-query?departure=BJS&arrival=SHA&departure_date=2026-11-02&flight_no=HO1254&max_segments=1"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

业务码	HTTP	说明
0	200	成功
4000	400	参数错误
4011	401	API Key 无效
4013	403	API Key 已暂停
4014	403	当前 IP 不在 Key 白名单
4015	401	此接口需要 API Key
4022	402	余额不足
4029	429	调用过快（QPS）
4030	429	今日免费额度已用完
4040	503	接口已下线
4041	404	接口不存在
5000	500	服务器内部错误
5020	502	上游暂时不可用
5021	502	上游返回格式异常
5030	502	暂无可用节点

调用限制

计费模式: 按次付费 · 点数包 · 月套餐
QPS 限制: QPS 5
登录免费额度: 无
匿名每日额度: 无
黄金会员: 本档不提供 VIP 额度 · QPS 10
钻石会员: 本档不提供 VIP 额度 · QPS 20
企业会员: 本档不提供 VIP 额度 · QPS 30

计费模式	按次付费 · 点数包 · 月套餐
QPS 限制	QPS 5
登录免费额度	无
匿名每日额度	无
黄金会员	本档不提供 VIP 额度 · QPS 10
钻石会员	本档不提供 VIP 额度 · QPS 20
企业会员	本档不提供 VIP 额度 · QPS 30

购买套餐、看评价请走商城详情。购买 / 调试

更新日志

1.0.02026-10-24
上架航班查询按次 0.330 元，查到航班才计费调用包单次价格最低 0.2222 元

免责声明

航班时刻与参考票价仅供行程安排参考，不构成航班必将执行的承诺，也不构成可按该价格出票的承诺。

共享航班的实际承运航班可能与销售航班号不同。中转航班请同时核对各航段的起降时间。

调用本接口即表示已阅读并同意上述说明。