Shipping Location Finder (USPS, UPS, FedEx)

Find nearby post offices, UPS stores, and FedEx locations. Get addresses, hours, services, and drop-off deadlines.

Features

Multi-Carrier Search

Search all three carriers with a single query:

Carrier	Location Types
USPS	Post Offices, Approved Shippers, Self-Service Kiosks, Collection Boxes
UPS	UPS Stores, Customer Centers, Access Points, Drop Boxes
FedEx	FedEx Office, Ship Centers, Drop Boxes, Authorized Ship Centers

Rich Location Data

Each location includes:

• Full address with GPS coordinates
• Phone number
• Hours of operation (by day)
• Services available
• Drop-off deadlines by service type
• Distance from search location

Sort by Distance

Results are automatically sorted by distance, showing the nearest locations first.

---

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	Default	Description
zipCode	string	No*	-	ZIP code to search near
address	string	No	-	Street address for precise search
city	string	No*	-	City name
state	string	No*	-	State abbreviation
radius	number	No	10	Search radius
radiusUnit	string	No	mi	Unit (mi or km)
carriers	array	No	All	Carriers to search
maxResults	number	No	20	Max locations to return
demoMode	boolean	No	true	Use sample data

*At least zipCode OR city+state is required.

---

Output Format

{
  "searchLocation": {
    "zipCode": "78701"
  },
  "radius": 10,
  "radiusUnit": "mi",
  "carriers": ["USPS", "UPS", "FedEx"],
  "locations": [
    {
      "carrier": "FedEx",
      "name": "FedEx Drop Box",
      "type": "Drop Box",
      "address": "500 E 4th St",
      "city": "Austin",
      "state": "TX",
      "zipCode": "78701",
      "country": "US",
      "phone": "",
      "distance": 0.2,
      "distanceUnit": "mi",
      "latitude": 30.2665,
      "longitude": -97.7400,
      "hours": {
        "monday": "24 Hours",
        "tuesday": "24 Hours",
        "wednesday": "24 Hours",
        "thursday": "24 Hours",
        "friday": "24 Hours",
        "saturday": "24 Hours",
        "sunday": "24 Hours"
      },
      "services": ["Package Drop-off"],
      "dropOffDeadlines": [
        { "service": "FedEx Express", "deadline": "6:00 PM" }
      ]
    },
    {
      "carrier": "USPS",
      "name": "Downtown Post Office",
      "type": "Post Office",
      "address": "100 E 6th St",
      "city": "Austin",
      "state": "TX",
      "zipCode": "78701",
      "country": "US",
      "phone": "(512) 555-0100",
      "distance": 0.3,
      "distanceUnit": "mi",
      "latitude": 30.2672,
      "longitude": -97.7431,
      "hours": {
        "monday": "8:30 AM - 5:00 PM",
        "tuesday": "8:30 AM - 5:00 PM",
        "wednesday": "8:30 AM - 5:00 PM",
        "thursday": "8:30 AM - 5:00 PM",
        "friday": "8:30 AM - 5:00 PM",
        "saturday": "9:00 AM - 1:00 PM",
        "sunday": "Closed"
      },
      "services": ["Retail Services", "PO Boxes", "Passport Services", "Money Orders"],
      "dropOffDeadlines": [
        { "service": "Priority Mail Express", "deadline": "5:00 PM" },
        { "service": "Priority Mail", "deadline": "5:00 PM" }
      ]
    }
  ],
  "uspsCount": 3,
  "upsCount": 3,
  "fedexCount": 3,
  "totalCount": 9,
  "queriedAt": "2025-01-14T12:00:00.000Z"
}

---

Pricing

This actor uses pay-per-event billing:

• data_point: $0.01 per result

Use Cases

E-commerce Returns

Help customers find the nearest drop-off location for returns. Show them options for all carriers.

Shipping Apps

Build a "ship from here" feature that shows nearby locations on a map.

Store Locators

Create a shipping location finder for your website or app.

Logistics Planning

Find locations with specific services (passport, notary, dangerous goods, etc.).

Last-Minute Shipping

Find locations open late or with latest drop-off deadlines to meet shipping cutoffs.

---

---

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