支持 1700+ 物流商，轻松掌握跨境包裹物流实况
Track123 API，打通1700+ 全球物流商的轨迹查询能力
通过 Track123 API，用一个统一接口实时查询全球 1700+ 物流商的运输轨迹，毫秒级响应，99.99% 稳定运行。
已被全球 60,000+ 企业信赖
为什么选择 TRACK123
为全球物流与电商打造轨迹查询能力
在跨境电商、物流平台和 SaaS 系统中，包裹通常涉及多个国家和不同物流商。
Track123 提供统一的物流轨迹查询 API，帮助你快速接入并稳定运行。
一个 API 替代多个接口
无需逐一对接各家物流商，一次集成即可覆盖全部，大幅降低开发和维护成本。
国内外包裹统一追踪
支持跨境直发、海外仓、尾程派送等复杂链路，全链路轨迹整合，一个单号获取完整更新。
减少「包裹在哪？」咨询
提升物流可视化能力，让买家随时掌握订单状态，显著降低 WISMO 客服压力。
Track123 已支持1700+ 全球物流商
数据实力
99.99%
API 正常运行率
1700+
全球物流商对接
15亿+
总追踪单量
60000+
服务企业数
200万+
日查询次数
<1天
从注册到上线
核心能力
1700+ Carriers ● Real-time
实时响应
毫秒级响应，第一时间同步全球物流状态
Track123 API 专为高并发、高频查询场景设计，确保你在任何规模下都能即时获取最新物流动态。
100 毫秒级 API 响应，支持创建运单、查询轨迹、获取最新状态
覆盖 1700+ 全球主流物流商，支持跨境直发、海外仓、尾程派送等复杂链路
实时 Webhook 推送，轨迹一旦变化即刻回调，无需轮询
支持高并发场景，适用于订单高峰期、电商大促与平台级系统
物流状态更新可在秒级同步至你的系统、前端页面或通知流程
TRACKING NUMBER
9261290100830368973 · USPS
待揽收 运输中 派送失败 重新派送 签收 ✓
已签收
重新派送
派送失败 · 无法进入派送地址
首次派送
到达分拨中心
待揽收
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 演示
真实接口，真实数据
选择一个运单号，查看 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"
}
]
}'
--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"}
客户案例
全球领先企业的共同选择
从 DTC 品牌到亿级平台，Track123 帮助不同规模的企业解决物流追踪难题。
客户案例
全球领先企业的共同选择
从 DTC 品牌到亿级平台，Track123 帮助不同规模的企业解决物流追踪难题。
常见问题
我们来解答你的疑问
什么是 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 天上线。
