快递查询PRO

express-proGET
GEThttps://v1.apizero.cn/api/express-pro
获取 API Key工作台购买 / 调试

概述

查询运单的承运商、当前状态与轨迹明细。承运商编码可以省略，省略后由系统根据运单号识别。覆盖 2000 余家承运商。 按次计费。查询顺丰速运、中通快递时，须同时提交手机号码后 4 位。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/express-pro/raw.md
打开 Markdown

鉴权

按次计费。月度调用包调用量越大，单次价格越低。查询顺丰速运、中通快递时，须提交手机号码后 4 位。

获取 API Key

请求头

Authorizationstring必填

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

自动识别（推荐）

GETURL QUERY·APPLICATION/JSON

承运商编码可以省略。省略时，系统按运单号识别承运商。以 JD、JDV 开头的运单按京东物流查询。

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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 sf，查询顺丰速运。须提交手机号码后 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 zto，查询中通快递。部分运单须提交手机号码后 4 位。

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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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

承运商编码 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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，查询中国邮政 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

返回结果

numberstring

单号

comstring

公司编码

com_namestring

公司中文名

statusstring

状态码（如 EMPTY / TRANSIT / SIGNED）

status_descstring

状态说明

tracesarray

轨迹：time / content

timestring

时间

contentstring

内容

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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"
}

请求示例

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

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=yunda&phone=1234"

错误码

先看业务 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

暂无可用节点

调用限制

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

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

更新日志

  • 1.3.02026-10-08

    按次单价调整为 0.012375 元，上浮 25% 月度调用包按调用量分档，上浮 10% 至 25% 企业会员不提供本接口调用额度

  • 1.2.02026-10-08

    计费单价调整为 0.0198 元/次 调用按次扣费 月度调用包单价与单次价格一致

  • 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

    接口说明调整为按次计费

免责声明

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