Shipping Location Finder (USPS, UPS, FedEx)

Find nearby USPS, UPS, and FedEx shipping locations from the carriers’ official US location directories. Enter a five-digit ZIP code and receive normalized records for post offices, carrier stores, authorized shipping outlets, drop-off partners, and other listed service points.

This Actor is designed for logistics apps, returns workflows, customer-support tools, local directory enrichment, and AI agents that need one consistent result shape across the three major US parcel carriers.

What it extracts

Field	Description
carrier	USPS, UPS, or FedEx
locationId	Carrier directory identifier
name, locationType	Public location name and carrier-defined category
streetAddress, city, state, postalCode	Normalized US address fields
phone	Public location or carrier phone number, when listed
latitude, longitude	Exact coordinates when exposed by the official directory
distanceMiles	Distance from the query ZIP centroid
distanceIsApproximate	true when distance is based on ZIP centroids
hours	Weekly carrier-published hours when available
services	Drop-off or service information shown on the listing
sourceUrl	Official carrier page used for the record
queriedZipCode, scrapedAt	Search provenance and collection timestamp

When to use it

Use this Actor when you need a bounded, repeatable location lookup by US ZIP code. It is a good fit for showing nearby return points, comparing carrier coverage, routing a customer to a staffed counter, or feeding normalized locations into another Actor or agent.

Do not use it as a routing engine, a guarantee that a location accepts a particular parcel, or a source of real-time holiday closures. Confirm time-sensitive services and opening hours on the linked carrier page before sending a customer to a location.

Input

Field	Type	Default	Notes
zipCode	string	10001	Required five-digit US ZIP code
carriers	array	all three	Any combination of USPS, UPS, and FedEx
radiusMiles	integer	10	1–25 miles
maxResults	integer	50	1–200 records across all carriers
proxyConfiguration	object	US residential Apify Proxy	Used only for the Akamai-protected USPS browser path

Example input:

{
  "zipCode": "10001",
  "carriers": ["USPS", "UPS", "FedEx"],
  "radiusMiles": 10,
  "maxResults": 25,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Run through the Apify API:

curl -X POST "https://api.apify.com/v2/acts/<username>~shipping-location-finder/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"zipCode":"10001","carriers":["USPS","UPS","FedEx"],"radiusMiles":10,"maxResults":25}'

The dataset can then be read through the run’s defaultDatasetId, while the OUTPUT key-value-store record contains per-carrier diagnostics.

Output example

{
  "carrier": "FedEx",
  "locationId": "TSSAA",
  "name": "FedEx at Walgreens",
  "locationType": "FedEx at Walgreens",
  "streetAddress": "383 W 31st St",
  "city": "New York",
  "state": "NY",
  "postalCode": "10001",
  "countryCode": "US",
  "phone": "(800) 463-3339",
  "latitude": null,
  "longitude": null,
  "distanceMiles": 0,
  "distanceIsApproximate": true,
  "hours": null,
  "services": [],
  "sourceUrl": "https://local.fedex.com/en-us/ny/new-york/tssaa",
  "queriedZipCode": "10001",
  "scrapedAt": "2026-08-27T06:00:00.000Z"
}

Pricing

The Actor uses transparent pay-per-event pricing. Apify automatically charges both synthetic events; the code does not manually charge them.

Event	Price	Charged when
Actor start	$0.00005	A run starts (once up to 1 GB memory)
Shipping location (shipping-location)	$0.002	One validated record is written to the default dataset

A run returning 25 locations costs approximately $0.05005 in event charges. A truthful empty or blocked run has no location-item charges; only the start event applies. The configured maximum run charge and maxResults remain the user’s cost controls.

Reliability and limitations

UPS and FedEx expose server-rendered official directory pages, so the Actor fetches and parses those pages directly. It discovers carrier-owned city pages from the relevant state directory rather than relying on a third-party geocoder.

The official USPS locator is JavaScript-driven and protected by Akamai. The Actor uses one consistent Playwright session and a US residential proxy for that path. If USPS blocks the session, UPS and FedEx results are preserved and OUTPUT.carrierOutcomes identifies USPS as blocked. No fabricated USPS records are added and no result events are charged for missing records.

Distance is exact when a carrier exposes coordinates. Otherwise it is an approximation between the query and result ZIP centroids, and distanceIsApproximate is set to true. Carrier directory coverage, services, and hours can change without notice. The Actor limits nearby city discovery to 20 cities per run to keep runtime and cost bounded.

Legal and data use

The Actor reads public carrier location pages and returns factual business-location information with a link to the official source. Follow the carriers’ terms, applicable law, and Apify’s policies. Do not use the data for spam, surveillance, or decisions involving sensitive personal information. Carrier names and trademarks belong to their respective owners; this Actor is not endorsed by USPS, UPS, or FedEx.

Support

If a carrier changes its directory markup, include the run ID, input ZIP code, affected carrier, and the OUTPUT diagnostic in your issue. Do not include Apify tokens, proxy URLs, cookies, or other secrets.