Zippopotam.us

Overview

Zippopotam.us resolves ZIP/postal codes to place names and coordinates — and vice versa — for ~40 countries, with a single keyless REST endpoint. A handy building block for address forms, shipping calculations, and postal-code autocomplete.

Quick Start

Look up a US ZIP code (verified live):

curl "https://api.zippopotam.us/us/90210"

{
  "post code": "90210",
  "country": "United States",
  "country abbreviation": "US",
  "places": [
    {
      "place name": "Beverly Hills",
      "state": "California",
      "state abbreviation": "CA",
      "latitude": "34.0901",
      "longitude": "-118.4065"
    }
  ]
}

Search by place (reverse lookup):

curl "https://api.zippopotam.us/us/CA/Beverly%20Hills"

Other countries use the same pattern:

curl "https://api.zippopotam.us/de/10115"     # Germany
curl "https://api.zippopotam.us/fr/75001"     # France
curl "https://api.zippopotam.us/jp/100-0001"  # Japan

Authentication

None — keyless.

Rate Limits & Notes

• Free and open; no documented hard limit — be polite.
• Country codes follow ISO 3166-1 alpha-2 (us, de, fr, jp…).
• Responses include place name, state/province, latitude/longitude — enough for basic geocoding.
• HTTPS is supported — use it (the listing URL is http).

FAQ

Is Zippopotam.us free? Yes — free and keyless.

Which countries are supported? Around 40 countries (ISO alpha-2 codes) — the US, most of Europe, Japan and more.

Can I reverse-lookup by place? Yes — /us/CA/Beverly Hills returns the matching ZIPs.