Carriers
TopYou Tracking API & MCP
Query live TopYou (topyou) package status and scan history in a single synchronous GET request or MCP tool call. TopYou number shapes are not documented, so pass ?carrier=topyou.
Overview & Quick Facts
| Property | Value |
|---|---|
Carrier slug (?carrier=) | topyou |
| Brand & service aliases | TopYou, Topyou Express, Shenzhen Tongyou (通邮集团), szty56 |
| Category | Chinese cross-border e-commerce forwarder |
| Single-package REST endpoint | GET https://api.lastscanned.com/v1/track/{trackingNumber}?carrier=topyou |
| Batch REST endpoint | GET https://api.lastscanned.com/v1/track?numbers=...&carrier=topyou |
MCP server (https://mcp.lastscanned.com) | track_package, track_packages, list_carriers (claude mcp add --transport http lastscanned https://mcp.lastscanned.com) |
| Authentication & pricing | Authorization: Bearer lsk_live_... · 1 free keyless lookup/day per IP · Free tier (5 unique numbers/day, $0) · Pro ($4.99/mo for 1,000 unique numbers, unlimited re-polls, $0.015/extra) |
Tracking Number Formats & Auto-Detection
| Pass | Rule / Regex | Examples |
|---|---|---|
Pass 1 (matches) | None (use ?carrier=topyou) | n/a |
Pass 2 (mayMatch) | None | n/a |
Required: always pass ?carrier=topyou; no shape is claimed in auto-detection.
Synchronous GET Request & Normalized JSON Response
curl
curl -s "https://api.lastscanned.com/v1/track/TY1234567890?carrier=topyou" \
-H "Authorization: Bearer $LASTSCANNED_API_KEY"MCP track_package tool call
{
"tool": "track_package",
"arguments": { "tracking_number": "TY1234567890", "carrier": "topyou" }
}Normalized TrackingResult JSON response
{
"carrier": "topyou",
"trackingNumber": "TY1234567890",
"status": "in_transit",
"statusDescription": "Departed from sorting center",
"service": null,
"deliveredAt": null,
"deliveredAtLocal": null,
"signedBy": null,
"destination": { "city": null, "state": null, "country": "US" },
"message": null,
"events": [
{
"timestamp": null,
"localTime": "2026-10-21T14:05:00",
"status": "in_transit",
"description": "Departed from sorting center",
"location": "Shenzhen",
"code": null
},
{
"timestamp": null,
"localTime": "2026-10-19T10:00:00",
"status": "in_transit",
"description": "Received at warehouse",
"location": "Shenzhen",
"code": null
}
]
}Notes
- Source: the JSON API behind
track.szty56.com(POST /order/track); several numbers go in one request. - Statuses: TopYou's own codes (pre-alert, warehouse in/out, transfer, destination country, customs, delivered, exception, returned) set the overall
status. - Handoff: when TopYou gives a transfer number for a partner carrier, it appears in
message. - Times: scans carry no zone, so only
localTimeis set.
Related Resources
- Carrier hub: All supported carriers
- Regex & check digits: Tracking number formats & auto-detection
- AI support workflows: WISMO AI agents & synchronous tracking
Equick China Tracking API & MCP
Track Equick China (EQK… cross-border waybills) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.
La Poste / Colissimo / Chronopost Tracking API & MCP
Track La Poste, Colissimo and Chronopost parcels and mail (13-character Colissimo numbers, S10 numbers ending FR) via synchronous REST GET or MCP. Normalized JSON status and scan history, no carrier credentials required.