加载接口文档…
快递物流查询-免费版
API查询申通、圆通、顺丰、中通、百世、极兔的物流轨迹。调用时请指定公司编码 com。顺丰、中通须传手机号后 4 位。 韵达、京东、EMS，以及不指定公司、由系统自动识别单号，请用快递查询 PRO。两套接口返回字段相同。
由 极数本源 提供·更新于 今天
16万
累计调用
482ms
平均响应
100.00%
服务可用性
10 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每天 3 次 · QPS 1
登录免费
当前方案每天 10 次 · QPS 1
黄金会员
每天 10,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/express
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/express?number=YT7460266600081&com=jt&phone=1234
接口信息备注
免费版指定极兔（com=jt）。
请求参数说明
number（单号）string
必填 · 快递单号（8–40 位字母数字） · 示例：YT7460266600081
com（快递公司）string
可选 · 快递公司编码，此处固定 jt · 默认 jt · 示例：jt
phone（手机号）string
可选 · 手机号后 4 位（顺丰 / 中通等场景可能需要） · 示例：1234
| 名称 | 类型 | 说明 |
|---|---|---|
| number（单号） | string | 必填 · 快递单号（8–40 位字母数字） · 示例：YT7460266600081 |
| com（快递公司） | string | 可选 · 快递公司编码，此处固定 jt · 默认 jt · 示例：jt |
| phone（手机号） | string | 可选 · 手机号后 4 位（顺丰 / 中通等场景可能需要） · 示例：1234 |
请求头说明
Authorizationstring
可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
numberstring
单号
comstring
公司编码
com_namestring
公司中文名
statusstring
状态码（如 EMPTY / TRANSIT / SIGNED）
status_descstring
状态说明
tracesarray
轨迹：time / content
timestring
时间
contentstring
内容
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||
|---|---|---|---|---|---|---|---|---|
| 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"
}免责声明
本接口数据由极数本源平台提供，仅供开发与测试参考。实际数据准确性、完整性与时效性以平台返回为准，平台不对因数据使用产生的任何后果承担直接责任。
请遵守《服务条款》《隐私政策》，不得将本接口用于违法、违规或侵犯他人权益的场景。
如发现数据异常或服务故障，请通过 contact@apizero.cn 反馈。