支持顺丰、中通、圆通、韵达、申通、京东、极兔等 100+ 家国内外快递公司的运单实时追踪，自动识别快递公司，返回全程物流轨迹节点、签收状态、签收人等信息，签收识别准确率达 99.8%，适用于电商、仓储、售后客服等场景。
快递物流跟踪 API 通过标准 HTTP GET 请求返回 JSON 格式的物流轨迹数据。支持按运单号与快递公司编码查询，可自动识别主流快递公司。返回字段涵盖运单号、快递公司、物流状态、完整轨迹节点数组、签收时间、签收人、寄件与收件城市等信息。顺丰等需实名快递需传入收件人手机后 4 位。接口全程 HTTPS 加密传输，支持高并发调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| number | string | 是 | 快递运单号。 |
| company | string | 否 | 快递公司编码，如 shunfeng、zhongtong、yuantong，不填则自动识别。 |
| phone | string | 否 | 收件人手机号后 4 位，顺丰等实名快递必填。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.number | string | 快递运单号。 |
| data.company | string | 快递公司名称。 |
| data.status | string | 当前物流状态：揽收、运输中、派送中、已签收、退回。 |
| data.traces | array | 物流轨迹节点数组，每项含 time（时间）与 desc（描述）。 |
| data.sign_time | string | 签收时间，格式 yyyy-MM-dd HH:mm:ss。 |
| data.sign_by | string | 签收人描述，如「本人签收」「代收点签收」。 |
| data.from | string | 寄件城市。 |
| data.to | string | 收件城市。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"number": "SF1234567890",
"company": "顺丰速运",
"status": "已签收",
"traces": [
{ "time": "2026-07-23 14:20:00", "desc": "快件已从【杭州转运中心】发出" },
{ "time": "2026-07-24 06:15:00", "desc": "快件已到达【上海浦东分拨中心】" },
{ "time": "2026-07-24 08:30:00", "desc": "快件正在派送中，派送员张师傅" },
{ "time": "2026-07-24 11:05:00", "desc": "快件已签收，签收人为本人" }
],
"sign_time": "2026-07-24 11:05:00",
"sign_by": "本人签收",
"from": "杭州",
"to": "上海",
"update_time": "2026-07-24 11:05:00"
}
}