USPS v3 SDKs

Ship USPS v3 from Python, Node.js, or PHP without rebuilding OAuth, token refresh, or brittle Web Tools adapters. MIT-licensed SDKs that replace the dead Web Tools wrappers developers are still stuck with.

Production-tested SDKs MIT Licensed 180 combined tests

20,553/mo

developers still pulling broken packages

Four USPS packages on PyPI, npm, and Packagist are still getting 20,500+ monthly installs — and every one of them has been hitting a 410 Gone since USPS Web Tools shut down on January 25, 2026.

usps-api

14,963/mo

PyPI · broken

usps-webtools

5,555/mo

npm · broken

pyusps

unmaint.

PyPI · broken

vinceg/usps

5+ yrs

Packagist · stale

If your requirements.txt or package.json still references one of these, your integration is already broken. The three SDKs below are drop-in replacements with the same shape and new USPS v3 plumbing.

Python

v1.0.2

pip install usps-v3

PyPI GitHub

Quick example

from usps_v3 import USPSClient

client = USPSClient(
    consumer_key="your_key",
    consumer_secret="your_secret"
)

result = client.addresses.validate(
    street_address="1600 Pennsylvania Ave NW",
    city="Washington",
    state="DC",
    zip_code="20500"
)
print(result["address"]["ZIPPlus4"])  # "0005"

Features

httpx async support File-based token cache Thread-safe OAuth snake_case API 67 tests 9 modules

Replaces

✕ usps-api (archived)
✕ usps-webtools (defunct)
✕ pyusps (unmaintained)

Node.js

v1.0.2

npm install usps-v3

npm GitHub

Quick example

import { USPSClient } from 'usps-v3';

const client = new USPSClient({
  consumerKey: 'your_key',
  consumerSecret: 'your_secret',
});

const result = await client.addresses.validate({
  streetAddress: '1600 Pennsylvania Ave NW',
  city: 'Washington',
  state: 'DC',
  ZIPCode: '20500',
});
console.log(result.address.ZIPPlus4); // "0005"

Features

TypeScript-first ESM + CJS dual File-based token cache Zero dependencies 54 tests 9 modules

Replaces

✕ usps-webtools-promise (archived)
✕ @usps/webtools (never existed)
✕ shipping-api (generic)

PHP

v1.0.0

composer require revaddress/usps-v3-php

Packagist GitHub

Quick example

use RevAddress\USPS\USPSClient;

$client = new USPSClient(
    consumerKey: 'your_key',
    consumerSecret: 'your_secret'
);

$result = $client->addresses->validate(
    streetAddress: '1600 Pennsylvania Ave NW',
    city: 'Washington',
    state: 'DC',
    zipCode: '20500'
);
echo $result['address']['ZIPPlus4']; // "0005"

Features

PHP 8.1+ Guzzle HTTP PSR-18 compatible File token cache 59 tests 9 modules

Replaces

✕ usps-php-api (abandoned)
✕ vinceg/usps (5+ years stale)

Don't want to manage USPS credentials?

RevAddress handles OAuth, rate limits, and token refresh. Get an API key and start validating addresses in 60 seconds.

Get Free API Key API Documentation