USPS API 调整后，追踪出问题了？几分钟解决：一个密钥，无需 OAuth，前 1,000 次查询免费。

USPS 物流追踪 API用一个 API 密钥，以实时状态回答“我的包裹到哪了？”

在您的店铺、应用或客服系统中展示实时 USPS 状态。一个 API 密钥、简洁的 JSON、批量查询与 Webhook——为美国、欧洲和亚洲的电商团队打造。

获取 1,000 次免费查询查看文档

1,000 次免费查询 · 自助注册 · 公开定价

在线实时查询 USPS 单号

今日剩余 5 次免费实时查询

USPS

USPS 追踪单号

9589 0710 5270 2634 8701 31

运输中

Your item is in transit to the next facility.

In Transit to Next Facility
— · November 11, 2026 9:18 AM
Departed USPS Regional Facility
CHICAGO, IL 60607 · November 11, 2026 3:14 AM
Arrived at USPS Regional Destination Facility
CHICAGO, IL 60607 · November 10, 2026 9:12 PM
USPS in possession of item
DALLAS, TX 75260 · November 9, 2026 7:36 PM

{
  "trackingNumber": "9589071052702634870131",
  "found": true,
  "delivered": false,
  "status": "In Transit",
  "statusDetail": "In Transit to Next Facility",
  "statusCategory": "in-transit",
  "latestUpdate": "Your item is in transit to the next facility.",
  "mailingDate": "2026-11-09",
  "product": {
    "name": "USPS Ground Advantage™",
    "features": [
      "USPS Tracking®",
      "Up to $100 insurance included"
    ]
  },
  "events": [
    {
      "status": "In Transit to Next Facility",
      "date": "November 11, 2026 9:18 AM",
      "localTime": "2026-11-11T09:18:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-11T09:18:00-06:00"
    },
    {
      "status": "Departed USPS Regional Facility",
      "location": "CHICAGO, IL 60607",
      "city": "CHICAGO",
      "state": "IL",
      "zip": "60607",
      "date": "November 11, 2026 3:14 AM",
      "localTime": "2026-11-11T03:14:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-11T03:14:00-06:00"
    },
    {
      "status": "Arrived at USPS Regional Destination Facility",
      "location": "CHICAGO, IL 60607",
      "city": "CHICAGO",
      "state": "IL",
      "zip": "60607",
      "date": "November 10, 2026 9:12 PM",
      "localTime": "2026-11-10T21:12:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-10T21:12:00-06:00"
    },
    {
      "status": "USPS in possession of item",
      "location": "DALLAS, TX 75260",
      "city": "DALLAS",
      "state": "TX",
      "zip": "75260",
      "date": "November 9, 2026 7:36 PM",
      "localTime": "2026-11-09T19:36:00",
      "timeZone": "America/Chicago",
      "time": "2026-11-09T19:36:00-06:00"
    }
  ],
  "sourceUrl": "https://tools.usps.com/tracking/?tLabels=9589071052702634870131",
  "fetchedAt": "2026-11-11T18:00:00.000Z"
}

示例200 OK · 3.4 s

平均响应时间: 3.5s
成功率: >99%
客户与用户: 2,000+
100 万次套餐每 1,000 次查询: $5

为什么选择 Wonca

比 USPS 官方 API 更简单的替代方案

自 2026 年平台调整以来，基于 USPS API 开发需要 OAuth 应用、配额申请和访问审核。Wonca 将这一切简化为一个接口。

	直接对接 USPS	Wonca USPS API
认证方式	OAuth 2.0 应用与令牌刷新	请求头中一个 API 密钥
获取权限	开发者门户、审批、账户关联	注册后几分钟内生成密钥
调用量	默认配额，需手动申请提升	每月 25,000 至 100 万+ 次查询
批量单号	每次调用仅一个单号	一次请求批量查询
状态更新	自行开发并维护轮询	Webhook 推送到您的接口
成本	研发投入与授权条款	公开套餐，每月 $199 起

Wonca 并非 USPS 官方 API。我们是独立的数据处理与整理服务：将 USPS 追踪信息整理为干净、标准化、可直接使用的数据，交付到您的系统。

核心能力

规模化追踪 USPS 包裹：单号查询、批量查询与 Webhook

单号查询

提交 USPS 追踪单号，平均约 3.5 秒返回状态与完整轨迹 JSON。

批量查询

一次操作查询多个单号，适合夜间同步与订单看板。

监控与 Webhook

只需登记一次，每个新的 USPS 事件都会推送到您的接口，无需轮询。

完整物流轨迹

每次扫描的时间、地点与 USPS 事件描述，从揽收到签收。

兼容任何技术栈

只要能发送 HTTPS 请求并读取 JSON：Node、Python、PHP、Java、Shopify 应用、ERP 及无代码工具。

可预测的账单

月度配额、固定价格、包含全部功能。无附加费用，无意外账单。

应用场景

为依赖 USPS 的团队而生

电商品牌

在订单页和邮件中展示实时 USPS 状态，在“我的包裹在哪？”变成工单之前就给出答案。

跨境卖家

从中国、欧洲或拉美发往美国？在一个地方追踪 USPS 尾程派送。

3PL 与仓配

将 USPS 事件接入 WMS 或 OMS，包裹停滞时第一时间通知客户。

客服与 CX 团队

让客服和聊天机器人即时获得准确答案，无需打开 usps.com。

接入流程

三步接入 USPS 物流追踪

创建密钥
注册并在控制台生成 API 密钥，前 1,000 次查询免费。
提交追踪单号
通过 HTTPS POST USPS 单号，并在 Authorization 请求头中携带密钥。
使用返回数据
在店铺中展示状态、触发邮件，或通过 Webhook 将事件推送至您的系统。

打开技术指南

curl -X POST \
  https://api.wonca.com.br/wonca.labs.v1.LabsService/Track \
  -H "Authorization: Apikey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "9589071052702634870131", "carrier": "CARRIER_USPS" }'

{
  "payload": {
    "trackingNumber": "9589071052702634870131",
    "found": true,
    "delivered": false,
    "status": "In Transit",
    "statusDetail": "In Transit to Next Facility",
    "statusCategory": "in-transit",
    "latestUpdate": "Your item is in transit to the next facility.",
    "mailingDate": "2026-11-09",
    "product": {
      "name": "USPS Ground Advantage™",
      "features": [
        "USPS Tracking®",
        "Up to $100 insurance included"
      ]
    },
    "events": [
      {
        "status": "In Transit to Next Facility",
        "date": "November 11, 2026 9:18 AM",
        "localTime": "2026-11-11T09:18:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-11T09:18:00-06:00"
      },
      {
        "status": "Departed USPS Regional Facility",
        "location": "CHICAGO, IL 60607",
        "city": "CHICAGO",
        "state": "IL",
        "zip": "60607",
        "date": "November 11, 2026 3:14 AM",
        "localTime": "2026-11-11T03:14:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-11T03:14:00-06:00"
      },
      {
        "status": "Arrived at USPS Regional Destination Facility",
        "location": "CHICAGO, IL 60607",
        "city": "CHICAGO",
        "state": "IL",
        "zip": "60607",
        "date": "November 10, 2026 9:12 PM",
        "localTime": "2026-11-10T21:12:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-10T21:12:00-06:00"
      },
      {
        "status": "USPS in possession of item",
        "location": "DALLAS, TX 75260",
        "city": "DALLAS",
        "state": "TX",
        "zip": "75260",
        "date": "November 9, 2026 7:36 PM",
        "localTime": "2026-11-09T19:36:00",
        "timeZone": "America/Chicago",
        "time": "2026-11-09T19:36:00-06:00"
      }
    ],
    "sourceUrl": "https://tools.usps.com/tracking/?tLabels=9589071052702634870131",
    "fetchedAt": "2026-11-11T18:00:00.000Z"
  },
  "carrier": "CARRIER_USPS",
  "status": "TRACKING_STATUS_FOUND"
}

价格

USPS 物流追踪 API 价格：所有套餐包含全部功能

选择月度查询配额，每个计费周期自动续期。每月需要超过 100 万次查询？我们为您量身定制。

1,000次免费查询

注册即送

前 1,000 次查询由我们承担。

创建账户、生成密钥，在您自己的系统中使用真实的 USPS 单号。足够在付费之前追踪您接下来的 1,000 笔订单。

真实 USPS 数据，而非沙盒
几分钟内自助完成接入
准备好后再选择套餐

获取 1,000 次免费查询

入门版
适合新店与试点
$199/月
25,000
次查询 / 月
$7.96 每 1,000 次查询
选择套餐
成长版
适合成长中的店铺
$399/月
50,000
次查询 / 月
$7.98 每 1,000 次查询
选择套餐
最受欢迎
规模版
适合成熟品牌
$749/月
100,000
次查询 / 月
$7.49 每 1,000 次查询
节省 6% （相比入门版）
选择套餐
商务版
适合平台与 3PL
$2,999/月
500,000
次查询 / 月
$6.00 每 1,000 次查询
节省 25% （相比入门版）
选择套餐
企业版
适合高用量业务
$5,000/月
1,000,000
次查询 / 月
$5.00 每 1,000 次查询
节省 37% （相比入门版）
选择套餐
合作伙伴版
适合每月超过 100 万次的大型合作伙伴
100万+
次查询 / 月
定制价格
低至 $0.20 每 1,000 次查询
最高优惠 97%
相比入门版单价，视用量而定
- 与您协商的阶梯价格
- 专属对接人与直连支持
- 定制部署、账单与上线协助
联系销售

所有套餐均包含：

USPS 单号与批量查询
监控与 Webhook
JSON 完整轨迹
HTTPS 与 API 密钥认证
文档与邮件支持

USPS 物流追踪 API 常见问题

还有没解答的问题？告诉我们您的用量与技术栈，我们帮您选择合适的套餐。

联系销售

可以免费测试多少次？

前 1,000 次查询免费。创建账户、生成密钥，即可使用真实的 USPS 单号测试 API，准备上线时再选择套餐。

免费查询用完后怎么办？

选择套餐即可继续追踪。免费查询在注册后限时有效，请在测试接入期间使用。

什么算一次查询？

每次追踪请求消耗月度配额中的一次查询。配额在每个计费周期续期。

API 速度如何？

实时 USPS 查询的平均响应时间为 3.5 秒，成功率超过 99%。

这是 USPS 官方 API 吗？

不是。Wonca 是独立的数据处理与整理服务，与 USPS 无隶属关系。我们处理 USPS 追踪信息，并以干净、标准化的 JSON 交付，您的团队无需自行对接官方接口。

我需要自己的 USPS 开发者账号吗？

不需要。您只需一个 Wonca API 密钥，与 USPS 的连接由我们负责。

可以一次查询多个单号吗？

可以。使用批量查询一次处理多个单号，或通过监控与 Webhook 自动接收更新。

能否兼容我的平台？

只要系统能发送 HTTPS 请求并读取 JSON 即可——任何编程语言、ERP、电商平台或自动化工具。

每月需要超过 100 万次查询怎么办？

企业版每月 $5,000 含 100 万次查询（每 1,000 次 $5）。用量更大时，合作伙伴版为大型合作伙伴提供低至每 1,000 次 $0.20 的定制价格（最高优惠 97%），并配备专属对接人。

是否支持其他承运商？

支持。除 USPS 外，我们还支持巴西 Correios、菜鸟 CAINIAO 与巴西 J&T Express（极兔）。

今天就为您的客户提供实时 USPS 追踪。

先用 1,000 次免费查询开始，再以每月 $199 起正式上线，或联系我们定制大批量方案。

获取 1,000 次免费查询联系销售