Multi-Carrier Package Tracking (USPS, UPS, FedEx)

Track packages across USPS, UPS, and FedEx with a single API call. Auto-detects carrier from tracking number format.

Features

Automatic Carrier Detection

No need to specify which carrier — the actor analyzes the tracking number format and routes to the correct API:

Carrier	Example Pattern	Detection
UPS	1Z999AA10123456784	Starts with "1Z" + 16 chars
USPS	9400111899223456789012	Starts with 94/92/93 + 20 digits
FedEx	794644790138	12-15 digits

Unified Response Format

All carriers return the same structured data:

• Current status and location
• Estimated and actual delivery dates
• Full event history with timestamps
• Error handling with clear messages

Demo Mode

Test integrations without API credentials. Enable demoMode: true to get realistic sample data.

---

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
See input schema

Output Format

{
  "trackingNumber": "1Z999AA10123456784",
  "carrier": "UPS",
  "status": "Delivered",
  "statusDetail": "DELIVERED",
  "estimatedDelivery": null,
  "deliveredDate": "2025-01-13T14:23:00Z",
  "lastUpdate": "2025-01-13T14:23:00Z",
  "location": "Austin, TX 78701 US",
  "events": [
    {
      "timestamp": "2025-01-13T14:23:00Z",
      "status": "Delivered",
      "location": "Austin, TX 78701 US",
      "details": "Left at front door"
    },
    {
      "timestamp": "2025-01-13T08:15:00Z",
      "status": "Out For Delivery",
      "location": "Austin, TX 78701 US",
      "details": "On UPS vehicle for delivery"
    },
    {
      "timestamp": "2025-01-12T22:45:00Z",
      "status": "Departed Facility",
      "location": "Dallas, TX 75261 US",
      "details": "Departed UPS facility"
    }
  ]
}

---

Pricing

This actor uses pay-per-event billing:

• data_point: $0.01 per result

Use Cases

E-commerce Order Tracking

Build customer-facing tracking pages that work with any carrier your suppliers use.

Shipping Automation

Trigger workflows when packages are delivered or delayed:

• Send delivery confirmation emails
• Update inventory systems
• Alert customers about delays

Logistics Dashboards

Monitor all shipments across carriers in a unified view.

Customer Support

Quickly look up any tracking number without switching between carrier websites.

---

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal