Geocoding — entry 079 of 80

Zippopotam.us

Verified Jul 2026

Zippopotam.us is a free, keyless geocoding lookup for place names: given a country code and postal/zip code it returns the place name, state/region, and latitude/longitude as JSON. It runs behind Cloudflare and now serves everything over HTTPS with an open Access-Control-Allow-Origin: * header, despite older docs still linking the plain-http form.

Zippopotam.us is a free, keyless lookup for postal codes worldwide. Send a country code and a postal or zip code, and it returns the matching place name, state or region, and coordinates as JSON. The service runs behind Cloudflare over HTTPS, with an open CORS header on every response.

postal-codegeocodingfreeno-authworldwide
AuthenticationNone requiredCall it straight away — no key, no signup.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreeNo paid tier — free for the documented use case.
FormatsJSONResponses can be requested as JSON.

GreatAPIs Score

Score88out of 100
Authentication25/25No authentication required
Pricing20/20Free to use
Docs14/20Documentation URL provided
Formats9/15Single response format
Freshness20/20Verified within 6 months

Embed this badge

Scored 88 on greatapis.com
<a href="https://greatapis.com/api/zippopotam-us/"><img src="https://greatapis.com/badge/zippopotam-us.svg" alt="Scored 88 on greatapis.com"></a>

Auth quickstart

  1. No API key or sign-up needed. Every request is a plain GET, and the response carries access-control-allow-origin: *, so you can call it straight from browser JavaScript.
Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Look up a US zip code

GEThttps://api.zippopotam.us/us/90210

200 application/json

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

Developer reference

Gotchas & limits

  • Field names in the response body use spaces, not camelCase or snake_case: "post code" and "place name", not postCode or place_name. Your JSON parser needs bracket access (data["post code"]) rather than dot access for these fields.
  • A postal code with no match does not return a 404 with an error message. A live probe of GET /us/00000 returned HTTP 404 with an empty JSON body: {}. Check for an empty object rather than reading an error field.
  • Every response, including the 404 case, carries access-control-allow-origin: * (confirmed live on both the successful and empty-body probes above).