返回首页

快递查询

/api/v1/express_query 0.15 积分/次(约 ¥0.0075/次) 运行中
支持一千多家快递公司,覆盖顺丰、申通、圆通、宅急送、韵达、中通、百世、天天、四通一达、京东、EMS等快递物流公司,与官网同步数据更新。另提供快递订阅推送接口,按单号计费,即同一单号计费一次。 —— 我们只做精品!

请求示例

request
curl -X POST https://api.zhuimengapi.com/api/v1/express_query \
  -H "X-API-Key: RPA-xxxxxxxx"
  -d "expressCode=your_expressCode \
  -d "number=your_number \
  -d "mobile=your_mobile \
  -d "sort=your_sort"
import requests

url = "https://api.zhuimengapi.com/api/v1/express_query"
headers = {"X-API-Key": "RPA-xxxxxxxx"}
data = {
  "expressCode": "your_expressCode",
  "number": "your_number",
  "mobile": "your_mobile",
  "sort": "your_sort"
}

res = requests.post(url, data=data, headers=headers)
print(res.json())
const axios = require('axios');

axios.post("https://api.zhuimengapi.com/api/v1/express_query", {
    expressCode: "your_expressCode",
    number: "your_number",
    mobile: "your_mobile",
    sort: "your_sort"
}, {
  headers: { "X-API-Key": "RPA-xxxxxxxx" }
}).then(res => console.log(res.data));

响应示例

response.json
{
    "code": 0,
    "msg": "code 对应的描述",
    "charge": false,
    "taskNo": "本次请求号",
    "data": {
        "expressCode": "快递公司编号",
        "expressCompanyName": "快递公司名称",
        "expressCompanyLogo": "快递公司 logo",
        "number": "运单编号",
        "logisticsStatus": "物流状态,详见:物流状态编码对照表",
        "logisticsStatusDesc": "物流状态描述",
        "theLastMessage": "运单号物流流转当前最新描述",
        "theLastTime": "运单号物流流转当前最新变更时间",
        "takeTime": "从揽收到送达所耗时间",
        "courier": "快递员",
        "courierPhone": "快递员联系方式",
        "logisticsTraceDetails": []
    },
    "data.logisticsTraceDetails[].time": 0,
    "data.logisticsTraceDetails[].logisticsStatus": "物流状态,详见:物流状态编码对照表",
    "data.logisticsTraceDetails[].subLogisticsStatus": "物流子状态,详见:物流状态编码对照表",
    "data.logisticsTraceDetails[].desc": "物流路由信息描述内容",
    "data.logisticsTraceDetails[].areaCode": "路由节点所在地区行政编码",
    "data.logisticsTraceDetails[].areaName": "路由节点所在地区"
}
接口信息
请求地址 https://api.zhuimengapi.com/api/v1/express_query
请求方式 POST
Content-Type application/x-www-form-urlencoded
鉴权方式 X-API-Key: RPA-xxxxxxxx
expressCode string
快递公司编号,例如圆通:YTO,详见:快递公司编码对照表
number string 必填
运单编号
mobile string
手机号,顺丰速运、中通、跨越速运需要传入收/寄件人手机号或后四位手机号
sort string
物流明细排序,desc:倒序,asc:升序,默认asc
code int
状态码,200 表示成功,详见 code 返回码说明
msg string
code 对应的描述
charge bool
计费标志
taskNo string
本次请求号
data object
返回数据
expressCode string
快递公司编号
expressCompanyName string
快递公司名称
expressCompanyLogo string
快递公司 logo
number string
运单编号
logisticsStatus string
物流状态,详见:物流状态编码对照表
logisticsStatusDesc string
物流状态描述
theLastMessage string
运单号物流流转当前最新描述
theLastTime string
运单号物流流转当前最新变更时间
takeTime string
从揽收到送达所耗时间
courier string
快递员
courierPhone string
快递员联系方式
logisticsTraceDetails array
物流明细
data.logisticsTraceDetails[].time int
物流变更时间(毫秒时间戳)
data.logisticsTraceDetails[].logisticsStatus string
物流状态,详见:物流状态编码对照表
data.logisticsTraceDetails[].subLogisticsStatus string
物流子状态,详见:物流状态编码对照表
data.logisticsTraceDetails[].desc string
物流路由信息描述内容
data.logisticsTraceDetails[].areaCode string
路由节点所在地区行政编码
data.logisticsTraceDetails[].areaName string
路由节点所在地区
响应状态说明

不同接口的成功返回字段可能不同,请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构,失败调用不计费。

  • 200 请求成功返回字段以本接口的响应示例和实际结果为准,部分接口不包含 code 字段。 按接口规则计费
  • 400 参数或业务错误请求参数无效时返回安全、明确的修正提示。 不扣费
  • 401 API Key 无效密钥缺失、格式错误、无效或已经过期。 不扣费
  • 402 账户余额不足请充值后重试;本次请求不会进入接口处理。 不扣费
  • 403 访问被拒绝IP 规则限制,或当前账户无权调用仅限 VIP 的接口。 不扣费
  • 404 接口路由不存在请检查请求地址中的 API 路由是否正确。 不扣费
  • 405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法,并查看 Allow 响应头。 不扣费
  • 413 请求体过大单次请求最大允许 20MB。 不扣费
  • 429 请求频率超限请根据 Retry-After 响应头稍后重试。 不扣费
  • 500 系统服务异常请稍后重试;持续出现时请向技术支持提供 request_id。 不扣费
  • 502 接口服务暂时不可用接口处理异常或暂时不可用,请稍后重试。 不扣费
  • 503 系统服务暂时不可用服务正在恢复,请稍后重试。 不扣费
错误响应示例 使用 request_id 查询对应调用日志
{
  "code": 400,
  "message": "请输入有效的身份证号码",
  "data": null,
  "request_id": "1-xxxxxxxx",
  "time": "2026-07-29 12:00:00"
}
请求地址 https://api.zhuimengapi.com/api/v1/express_query
请求方式 POST
Content-Type application/x-www-form-urlencoded
鉴权 Header X-API-Key
Params Body
Params GET 请求只通过 URL 查询参数发送
Body 表单模式 POST + application/x-www-form-urlencoded 使用表单键值对请求体

快速信息

接口路由express_query
接口分类企业服务
请求方式POST
原价0.15 积分/次(约 ¥0.0075/次)
频率限制不限制
认证方式X-API-Key
接口提供官方接口

如何调用

  1. 注册/登录本站账号
  2. 前往用户中心 → API密钥 ,创建一个密钥
  3. 在请求头添加 X-API-Key 携带密钥即可调用
  4. 成功调用按页面标价扣除。
前往创建 API 密钥