Track123 API,打通1700+ 全球物流商的轨迹查询能力

通过 Track123 API,用一个统一接口实时查询全球 1700+ 物流商的运输轨迹,毫秒级响应,99.99% 稳定运行。

查看 API 文档

已被全球 60,000+ 企业信赖

为什么选择 TRACK123
为全球物流与电商打造轨迹查询能力

在跨境电商、物流平台和 SaaS 系统中,包裹通常涉及多个国家和不同物流商。

Track123 提供统一的物流轨迹查询 API,帮助你快速接入并稳定运行。

一个 API 替代多个接口
无需逐一对接各家物流商,一次集成即可覆盖全部,大幅降低开发和维护成本。
国内外包裹统一追踪
支持跨境直发、海外仓、尾程派送等复杂链路,全链路轨迹整合,一个单号获取完整更新。
减少「包裹在哪?」咨询
提升物流可视化能力,让买家随时掌握订单状态,显著降低 WISMO 客服压力。
Track123 已支持1700+ 全球物流商
4PX
An Post
Australia Post
CTT Express
Chronopost
Correos
Deutsche Post
J&T
La Poste
Poste Italiane
Purolator
SF Express
UPS
YunExpress
Amazon Shipping
Aramex
4PX
An Post
Australia Post
CTT Express
Chronopost
Correos
Deutsche Post
J&T
La Poste
Poste Italiane
Purolator
SF Express
UPS
YunExpress
Amazon Shipping
Aramex
4PX
An Post
Australia Post
CTT Express
Chronopost
Correos
Deutsche Post
J&T
La Poste
Poste Italiane
Purolator
SF Express
UPS
YunExpress
Amazon Shipping
Aramex
Colissimo
DHL
DPD
EMS
FedEx
GLS
Carrier
iMile
Live
New Zealand Post
OnTrac
PostNL
SPX
UniUni
Carrier
USPS
Colissimo
DHL
DPD
EMS
FedEx
GLS
Carrier
iMile
Live
New Zealand Post
OnTrac
PostNL
SPX
UniUni
Carrier
USPS
Colissimo
DHL
DPD
EMS
FedEx
GLS
Carrier
iMile
Live
New Zealand Post
OnTrac
PostNL
SPX
UniUni
Carrier
USPS
数据实力
99.99%
API 正常运行率
1700+
全球物流商对接
15亿+
总追踪单量
60000+
服务企业数
200万+
日查询次数
<1天
从注册到上线
核心能力
1700+ Carriers ● Real-time
实时响应
毫秒级响应,第一时间同步全球物流状态
Track123 API 专为高并发、高频查询场景设计,确保你在任何规模下都能即时获取最新物流动态。
100 毫秒级 API 响应,支持创建运单、查询轨迹、获取最新状态
覆盖 1700+ 全球主流物流商,支持跨境直发、海外仓、尾程派送等复杂链路
实时 Webhook 推送,轨迹一旦变化即刻回调,无需轮询
支持高并发场景,适用于订单高峰期、电商大促与平台级系统
物流状态更新可在秒级同步至你的系统、前端页面或通知流程
TRACKING NUMBER
9261290100830368973 · USPS
✓ 已签收
待揽收 运输中 派送失败 重新派送 签收 ✓
已签收
Austin, TX, US · Mar 18, 14:23
DELIVERED
重新派送
Austin, TX, US · Mar 18, 09:05
OUT_FOR_DELIVERY
派送失败 · 无法进入派送地址
Austin, TX, US · Mar 17, 15:47
DELIVERY_FAILED
首次派送
Austin, TX, US · Mar 17, 09:12
OUT_FOR_DELIVERY
到达分拨中心
Dallas, TX, US · Mar 16, 22:34
IN_TRANSIT
待揽收
Los Angeles, CA, US · Mar 15, 10:08
INFO_RECEIVED
AI 智能处理
从混乱原始轨迹,到标准化物流数据
物流数据更准、更清晰、更可信。AI 自动将来自不同承运商的原始轨迹整合为可直接使用的标准化数据。
自动标准化为 8 个核心状态 + 28 个子状态
统一处理揽收时间、运输节点、妥投时间、地点名称与时区差异
支持多承运商接力运输的全链路整合,一个单号获取完整更新
AI 自动识别新物流商与新单号规则,持续提升识别成功率
特别适用于跨境物流、Dropshipping、平台型系统与 SaaS 产品
「API测试页」企业稳定区块正常运行率图表标题
99.99%
100ms
平均响应时间
0
本月故障次数
企业级稳定
面向企业级系统设计的长期稳定 API
Track123 从架构层面保障 API 的长期可用性与一致性,让你专注业务而非维护基础设施。
SLA 99.99%,满足平台级与 SaaS 系统的可用性要求
分布式架构 + 多节点冗余,避免单点故障
智能降级与异常容错机制,应对物流商接口波动
长期维护与版本兼容策略,避免频繁改动影响业务
已在全球电商卖家、物流平台与 SaaS 系统中长期运行验证
完整 API 文档
RESTful + Webhook 双模式
示例代码
「API测试页」集成示例代码语言列表
企业级 SLA
7×24h 技术支持
● 可用
最快 1 天完成集成
注册即可开始,无需信用卡
快速集成
企业级无缝集成与全程技术支持
Track123 让你无需投入大量人力维护物流对接,也不必担心后续扩展与定制需求。
开放完整 API 文档,结构清晰、字段稳定,支持快速上手
提供多语言示例代码,减少重复开发成本
标准 RESTful API + Webhook 机制,轻松嵌入现有系统
最快 1 天完成接入,快速验证、快速上线
7×24 小时技术支持,提供企业级定制方案与专属 SLA
集成流程
只需四步,完成物流轨迹对接

一次集成,即可覆盖所有物流商。无需单独维护各家接口。

01

注册账号获取 API Key

免费注册 Track123 账号,立即获取 API Key,整个过程不超过 5 分钟。

02

提交运单号

通过 API 将运单号提交给 Track123,无需提前指定物流商,系统自动识别。

03

自动识别与查询

Track123 自动识别物流商,并从对应物流系统获取最新轨迹数据。

04

获取结果或接收推送

通过 API 获取标准化轨迹数据,或通过 Webhook 实时接收状态更新推送。

查看 API 文档
API 演示
真实接口,真实数据

选择一个运单号,查看 Track123 API 的真实请求与响应结构。

REQUEST · CURL
curl --request POST \
--url https://api.track123.com/gateway/open-api/tk/v2.1/track/query \
--header Track123-Api-Secret: XXXXXXXXXXXXXXX \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"trackNoInfos": [
{
"trackNo": "9500109441760092147847"
"courierCode": "usps"
}
]
}'
RESPONSE
  {  "code": "00000",  "data": {    "accepted": {      "content": [        {          "id": "824300786983985152",          "trackNo": "9500109441760092147847",          "createTime": "2026-03-24 15:17:02",          "nextUpdateTime": "2026-04-02 15:17:10",          "shipFrom": "US",          "shipTo": "US",          "trackingStatus": "001",          "transitStatus": "ABNORMAL",          "transitSubStatus": "ABNORMAL_08",          "receiptTime": "2026-01-17 08:26:00",          "lastTrackingTime": "2026-02-20 12:52:00",          "transitDays": 74,          "stayDays": 39,          "localLogisticsInfo": {            "courierCode": "usps",            "courierNameCN": "美国邮政",            "courierNameEN": "USPS",            "courierHomePage": "https://www.usps.com/",            "courierTrackingLink": "https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=9500109441760092147847",            "trackingDetails": [              {                "address": "",                "eventTime": "2026-02-20 12:52:00",                "eventTimeZeroUTC": "2026-02-20T16:52:00Z",                "timezone": "-04:00",                "eventDetail": "Sent to Mail Recovery Center",                "transitSubStatus": "ABNORMAL_03"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-02-20 12:47:00",                "eventTimeZeroUTC": "2026-02-20T16:47:00Z",                "timezone": "-04:00",                "eventDetail": "Out for Delivery",                "transitSubStatus": "WAITING_DELIVERY_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-02-20 12:36:00",                "eventTimeZeroUTC": "2026-02-20T16:36:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at Post Office",                "transitSubStatus": "IN_TRANSIT_07"              },              {                "address": "",                "eventTime": "2026-01-31 00:00:00",                "eventTimeZeroUTC": "2026-01-31T04:00:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-27 02:02:00",                "eventTimeZeroUTC": "2026-01-27T06:02:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-27 01:52:00",                "eventTimeZeroUTC": "2026-01-27T05:52:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-27 01:21:00",                "eventTimeZeroUTC": "2026-01-27T05:21:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-27 00:58:00",                "eventTimeZeroUTC": "2026-01-27T04:58:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-26 21:49:00",                "eventTimeZeroUTC": "2026-01-27T01:49:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-26 15:50:00",                "eventTimeZeroUTC": "2026-01-26T19:50:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-25 12:05:00",                "eventTimeZeroUTC": "2026-01-25T16:05:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-25 00:27:00",                "eventTimeZeroUTC": "2026-01-25T04:27:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-24 23:41:00",                "eventTimeZeroUTC": "2026-01-25T03:41:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-24 21:34:00",                "eventTimeZeroUTC": "2026-01-25T01:34:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-23 01:56:00",                "eventTimeZeroUTC": "2026-01-23T05:56:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "HOUSTON,TX",                "eventTime": "2026-01-23 01:54:00",                "eventTimeZeroUTC": "2026-01-23T05:54:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-23 01:26:00",                "eventTimeZeroUTC": "2026-01-23T05:26:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-22 19:31:00",                "eventTimeZeroUTC": "2026-01-22T23:31:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "SOUTH HOUSTON PROCESSING CENTER",                "eventTime": "2026-01-22 18:41:00",                "eventTimeZeroUTC": "2026-01-22T22:41:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "",                "eventTime": "2026-01-22 15:53:00",                "eventTimeZeroUTC": "2026-01-22T19:53:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "DALLAS,TX",                "eventTime": "2026-01-22 13:01:00",                "eventTimeZeroUTC": "2026-01-22T17:01:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "DALLAS,TX",                "eventTime": "2026-01-22 09:59:00",                "eventTimeZeroUTC": "2026-01-22T13:59:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "",                "eventTime": "2026-01-21 23:08:00",                "eventTimeZeroUTC": "2026-01-22T03:08:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "",                "eventTime": "2026-01-21 13:21:00",                "eventTimeZeroUTC": "2026-01-21T17:21:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NEWARK NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-21 05:09:00",                "eventTimeZeroUTC": "2026-01-21T09:09:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NEWARK NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-21 02:43:00",                "eventTimeZeroUTC": "2026-01-21T06:43:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "TRENTON NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-21 01:28:00",                "eventTimeZeroUTC": "2026-01-21T05:28:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "TRENTON NJ DISTRIBUTION CENTER",                "eventTime": "2026-01-19 17:02:00",                "eventTimeZeroUTC": "2026-01-19T21:02:00Z",                "timezone": "-04:00",                "eventDetail": "Arrived at USPS Facility",                "transitSubStatus": "IN_TRANSIT_02"              },              {                "address": "",                "eventTime": "2026-01-19 14:53:00",                "eventTimeZeroUTC": "2026-01-19T18:53:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "WARRENDALE PA DISTRIBUTION CENTER",                "eventTime": "2026-01-19 11:19:00",                "eventTimeZeroUTC": "2026-01-19T15:19:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-18 19:19:00",                "eventTimeZeroUTC": "2026-01-18T23:19:00Z",                "timezone": "-04:00",                "eventDetail": "Departed Post Office",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "",                "eventTime": "2026-01-18 03:30:00",                "eventTimeZeroUTC": "2026-01-18T07:30:00Z",                "timezone": "-04:00",                "eventDetail": "In Transit to Next Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-17 09:26:00",                "eventTimeZeroUTC": "2026-01-17T13:26:00Z",                "timezone": "-04:00",                "eventDetail": "Processed through USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              },              {                "address": "NORTH HOUSTON TX DISTRIBUTION CENTER",                "eventTime": "2026-01-17 08:26:00",                "eventTimeZeroUTC": "2026-01-17T12:26:00Z",                "timezone": "-04:00",                "eventDetail": "Accepted at USPS Facility",                "transitSubStatus": "IN_TRANSIT_01"              }            ]          },          "shipmentType": "USPS - USPS Ground Advantage"        }      ],      "totalElements": "1407",      "totalPages": "15",      "currentPage": "1",      "cursor": "2"    },    "rejected": []  },  "msg": "Success",  "traceId": "59f9e3940adc405986a3ea484bdf7a2b"}
常见问题
我们来解答你的疑问
什么是 Track123 物流追踪 API? +
Track123 物流追踪 API 是一个多承运商接口,可以让你的系统或平台实时获取订单的完整物流状态,包括运输主状态、子状态和异常节点,支持全球 1700+ 承运商的数据整合和标准化输出。
为什么选择多承运商 API 而不是单一承运商接口? +
单一承运商接口只能返回该物流商的轨迹,跨境电商或大规模零售会涉及多个承运商,数据分散且格式不统一。Track123 的多承运商 API 自动整合全球物流信息,标准化状态输出,并支持异常标记、延迟预警和实时通知,大幅降低开发复杂度和客服压力。
Track123 API 的稳定性和 SLA 是怎样的? +
Track123 提供企业级 SLA,API 稳定运行率达到 99.99%,多重云存储和分布式数据中心保障数据稳定可靠。同时,异常节点、延迟状态可自动标记,确保数据完整性。
Track123 API 如何保障数据安全和隐私? +
Track123 采用企业级安全架构,包括 HTTPS 加密传输、多重访问权限控制和分布式数据中心,确保物流数据安全与用户隐私合规。
Track123 API 如何收费? +
Track123 提供订阅套餐模式,基础套餐包含免费额度,超出后按运单数量阶梯计费,价格透明可预测。针对大客户或定制化需求,可提供专属报价和 SLA 服务。
如何开始使用 Track123 API? +
只需注册账号,获取 API Key,然后按照文档快速接入你的电商平台、ERP 或 SaaS 系统即可。我们提供专属技术对接和快速支持,确保集成顺利完成,最快 1 天上线。

立即开始使用 Track123 API

适用于电商平台、物流服务及企业内部系统。只需 1 天即可构建可视化物流体验,让用户随时掌握订单状态。

查看 API 文档