免费快递查询接口

一个 HTTP 请求，
拿到完整物流轨迹

面向个人开发者的快递查询api接口。统一的 JSON 返回结构，不必为每家快递公司单独写解析逻辑。每月 10,000 次免费额度， 无需注册即可在下方直接调用测试。

免费获取密钥查看接口文档

无需企业认证，个人开发者可直接使用
统一状态码，跨快递公司口径一致
支持批量查询，单次最多 10 个运单号

在线调用演示

快递公司运单号

请求

响应

点击「发送请求」查看真实返回结果。

为什么用这个快递查询接口

接入过程中最费时间的往往不是查询本身，而是各家格式不一致、注册流程繁琐。

统一返回结构

不同快递公司的原始状态被归一为 12 个标准状态码， DELIVERED、IN_TRANSIT 等口径全平台一致。

注册前可测试

公开演示密钥可直接调用（按 IP 限频）。确认返回结构符合需求后再注册，不必先填一堆资料。

面向个人开发者

无需企业营业执照或对公认证。邮箱注册即可拿到密钥，每月 10,000 次免费额度。

批量查询

单次请求最多传入 10 个运单号，返回中逐条给出成功/失败状态，便于后台批量对账。

跨境轨迹

菜鸟国际跨境包裹已可实际查询，覆盖出库、干线、清关到派送签收的完整节点。

清晰的错误码

NOT_FOUND、INVALID_TRACKING_NUMBER 等错误码语义明确，便于在代码里分支处理。

三步完成接入

从注册到跑通第一个请求，通常只需要几分钟。

注册获取密钥

邮箱注册后在控制台生成 API Key 与 Secret Key。

发起查询请求

向 /v1/tracking/trace POST 运单号，请求头带上 Bearer 认证。

解析统一结果

读取 status 与 progresses 数组即可。

# 查询单个运单号
curl -X POST https://api.kuaidichaxunapi.com/v1/tracking/trace \
  -H "Authorization: Bearer API_KEY:SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"courierCode":"cainiao","trackingNumber":"CGD0000123456"}]}'

支持的快递公司

覆盖国内主流快递公司与菜鸟国际跨境包裹。点击任意公司查看接口编码、运单号格式与调用示例。

菜鸟国际顺丰速运中通快递圆通速递申通快递韵达快递京东物流极兔速递中国邮政(EMS) 德邦快递

现在就开始接入

每月 10,000 次免费额度，个人开发者无需企业认证。

免费注册阅读文档

一个 HTTP 请求，拿到完整物流轨迹