Zippopotam.us API

Base URL

https://api.zippopotam.us

Authentication

No key or registration.

Rate limit

No published limit. Informal fair use applies.

Pricing

Completely free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 19 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://api.zippopotam.us/us/33162'

const res = await fetch("https://api.zippopotam.us/us/33162");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.zippopotam.us/us/33162", timeout=20)
res.raise_for_status()
print(res.json())

{
  "country": "United States",
  "country abbreviation": "US",
  "post code": "33162",
  "places": [
    {
      "place name": "Miami",
      "longitude": "-80.183",
      "latitude": "25.9286",
      "state": "Florida",
      "state abbreviation": "FL"
    }
  ]
}

post codestring

The postal code echoed back. Note the space in the key name.

country / country abbreviationstring

Country name and code — again, keys contain spaces.

placesarray

One or more matching places; a single code can map to several.

places[].place namestring

City or locality name.

places[].state / state abbreviationstring

State or region and its short code.

places[].latitude / longitudestring

Coordinates as strings, not numbers.

• Autofill city and state from a postal code in checkout and signup forms
• Validate that a postal code actually exists before submitting an order
• Get approximate coordinates for a postal code without a full geocoder
• Build country-aware address forms across 60+ countries with one integration

If Zippopotam.us does not fit, these geolocation & ip apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.