USA Data Tools
Log in Sign up
Free โ€ข No signup required

US Address Generator JSON API

Generate random US addresses programmatically โ€” single, batch, EIN, phone and ZIP lookup.

โ† Back to US Address Generator
โ„น Two API tiers. The free tier runs entirely in your browser and is great for prototyping and learning. The paid tier is a hosted REST endpoint for production workloads requiring high volume, SLAs and server-to-server access.

Authentication

The free tier requires no authentication โ€” it's a browser-only demo. The paid tier authenticates requests with an API key passed in the x-api-key header. You can generate a key from your account dashboard.

Endpoints

GET   /v1/address

Generate one random US address. Optionally restrict to a state by passing ?state=CA.

curl "https://api.us-address.example/v1/address?state=TX"\ -H "x-api-key: $API_KEY" โ†’ 200 OK { "name": "John Smith", "street": "123 Main St", "city": "Houston", "state": "TX", "zip": "77012", "phone": "(713) 555-0123", "email": "jsmith@example.com", "country": "United States" }

Live demo (browser)

Click below to simulate a request entirely in your browser โ€” no server, no key needed.

// output appears here

GET   /v1/batch

Generate up to 1000 addresses in a single request. Pass count and optional state.

curl "https://api.us-address.example/v1/batch?count=100&state=CA"\ -H "x-api-key: $API_KEY" โ†’ 200 OK { "count": 100, "addresses": [ { "name": "โ€ฆ", "street": "โ€ฆ", โ€ฆ }, โ€ฆ ] }

Live demo (browser)

Generate a batch result in your browser.

// output appears here

GET   /v1/ein

Generate one synthetic EIN in XX-XXXXXXX format.

curl "https://api.us-address.example/v1/ein" \ -H "x-api-key: $API_KEY" โ†’ { "ein": "47-1234567" }
// output appears here

GET   /v1/phone

Generate one random US phone number.

curl "https://api.us-address.example/v1/phone?state=NY" \ -H "x-api-key: $API_KEY" โ†’ { "phone": "(212) 555-0199", "intl": "+1 212-555-0199" }
// output appears here

GET   /v1/zip/{zip}

Look up a 5-digit ZIP and return the corresponding state + sample city.

curl "https://api.us-address.example/v1/zip/90001" \ -H "x-api-key: $API_KEY" โ†’ { "zip": "90001", "state": "CA", "stateFull": "California", "city": "Los Angeles" }

Live demo (browser)

Type a 5-digit ZIP and run the lookup locally.

// output appears here

Rate limits & pricing

TierAuthVolumeRatePrice
Free (browser demo)NoneUp to 1000 / page loadLocal$0
 StandardAPI key100k / month10 req/s$19 / mo
 ProAPI key1M / month50 req/s$49 / mo
 EnterpriseAPI key + SSOCustomCustomContact us
Note. The hosted endpoint domain (api.us-address.example) shown in the sample requests is illustrative โ€” replace it with the live endpoint URL from your account dashboard once you sign up.

Frequently Asked Questions

What does the free tier include?

A browser-only demo you can run from the live demo buttons on this page. It returns up to 1000 records per page load with no API key.

What's the difference between free and paid?

Paid gives you a hosted endpoint with API-key auth, higher rate limits, monthly quota and SLA. Perfect for CI pipelines, server-side seeding and production-volume testing.

Do I need an account for the free tier?

No. The free demo runs entirely in your browser. No signup, no API key.

Are the responses real addresses?

No. They are random and synthetic. Use them only for testing, fixtures and demos.