快递查询PRO

express-proGET

比免费版多自动识别，并多查韵达、京东、EMS 等 2000+ 家快递（免费版只有申通、圆通、顺丰、中通、百世、极兔）。可不传 com，系统按单号识别公司。顺丰、中通须传手机号后 4 位。返回字段与免费版相同。

GEThttps://v1.apizero.cn/api/express-pro

aidocs.page.getKey 工作台购买 / 调试

平台约定

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

/aidocs/express-pro/raw.md

打开 Markdown

鉴权

比免费版多自动识别，以及韵达、京东、EMS 等更多公司。按次 ¥0.011 或 1 点/次；也可买月卡（¥9.9 / ¥29.9 / ¥99.9）。顺丰/中通必须传 phone。六家常用快递可用免费版 /api/express。

获取 API Key：/account/keys

请求头

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

自动识别（推荐）

GETURL QUERY·APPLICATION/JSON

比免费版多：不传 com 即可自动识别。京东 JDV/JD 单号会按前缀当京东查。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=yto&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	可选公司编码；缺省由系统自动识别	yto
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

圆通 YTO

GETURL QUERY·APPLICATION/JSON

指定圆通快递（com=yto）。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=yto&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 yto	yto
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

顺丰 SF

GETURL QUERY·APPLICATION/JSON

指定顺丰快递（com=sf）。通常需传 phone=手机号后 4 位。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=sf&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 sf	sf
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

中通 ZTO

GETURL QUERY·APPLICATION/JSON

指定中通快递（com=zto）。部分单号需 phone。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=zto&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 zto	zto
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

申通 STO

GETURL QUERY·APPLICATION/JSON

指定申通快递（com=sto）。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=sto&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 sto	sto
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

韵达 YUNDA

GETURL QUERY·APPLICATION/JSON

指定韵达快递（com=yunda）。免费版没有韵达，请用本接口。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=yunda&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 yunda	yunda
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

极兔 JT

GETURL QUERY·APPLICATION/JSON

指定极兔快递（com=jt）。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=jt&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 jt	jt
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

京东 JD

GETURL QUERY·APPLICATION/JSON

指定京东快递（com=jd）。免费版没有京东，请用本接口。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=jd&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 jd	jd
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

EMS

GETURL QUERY·APPLICATION/JSON

指定 EMS（com=ems）。免费版没有 EMS，请用本接口。

https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=ems&phone=1234

参数	类型	必填	说明	示例
number	string	是	快递单号（8–40 位字母数字）	YT7460266600081
com	string	否	快递公司编码，此处固定 ems	ems
phone	string	否	手机号后 4 位（顺丰 / 中通等场景可能需要）	1234

响应字段

字段	类型	说明
number	string	单号
com	string	公司编码
com_name	string	公司中文名
status	string	状态码（如 EMPTY / TRANSIT / SIGNED）
status_desc	string	状态说明
traces	array	轨迹：time / content
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}

请求示例

将 YOUR_API_KEY 替换为真实 Key 后运行。

# 1. 密钥：登录 https://apizero.cn/account/keys 申请，写入环境变量 APIZERO_KEY
#    请求头 Authorization: Bearer <key>
import json
import os
import urllib.request

key = os.environ["APIZERO_KEY"]

# 2. 请求地址
url = "https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=yunda&phone=1234"

# 3. 发请求
req = urllib.request.Request(
    url,
    headers={"Authorization": "Bearer " + key},
)
with urllib.request.urlopen(req, timeout=15) as resp:
    body = json.loads(resp.read().decode("utf-8"))

# 4. 打印整包。
#   第 5 步的字段按本接口 data 里实际键改。
print(json.dumps(body, ensure_ascii=False, indent=2))

# 5. code == 0 后再取字段
if body.get("code") == 0:
    data = body.get("data") or {}
    print(data)

在线调试

填写参数后运行，将真实调用接口；计入免费额度。

RequestGET

GET https://v1.apizero.cn/api/express-pro

认证方式

参数(3)

numberstring必填

快递单号（8-40 位字母或数字）

comstring

快递公司编码（如 sf/yto/zto/sto/yunda/jt/jd/ems）；缺省由系统自动识别

phonestring

手机号后 4 位数字（仅顺丰 / 中通必填）

待运行

填写参数后点击「运行调试」查看响应

错误码

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

业务码	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 限制	2 req/s
登录免费额度	5 次（已认证）
匿名每日额度	2 次（无 API Key）
黄金会员	每日 30 次 · QPS 10
企业会员	每日 200 次 · QPS 120

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

变更日志

1.1.02026-08-30
按次价改为 ¥0.011（上游 ¥0.0099，加价约 12%）上架月卡：¥9.9 / 900 次 / QPS 20，¥29.9 / 2700 次 / QPS 30，¥99.9 / 9000 次 / QPS 40
1.0.02026-08-28
上架：比免费版多自动识别，覆盖韵达、京东、EMS 等更多公司

免责声明

本接口数据由极数本源平台提供，仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准。