PostalCodes

Search postal codes and places worldwide

🗺 Geo & MapsUNMONITOREDchecked 27 min ago
AUTH NONECORS AGENT HTTPS COMMERCIAL ?

A keyless search endpoint that returns matching towns, regions and postal-code sets across many countries as JSON. Useful for autocomplete over global postal data; the site also offers per-country bulk exports.

HOW IT'S SCORED ⓘ
Status badge · for your READMEshipapis health badge: — · unmonitored
Uptime history
—%90 days
—%30 days
P50 · ms
P95 · ms
operationalpartialdownno data
Live response samplecaptured by our last successful check
GET https://postalcodes.info/search?q=madrid

[
  {
    "type": "Town/City",
    "text": "Madrid",
    "sub": "Spain · 55 codes",
    "url": "/postal-codes/spain/madrid/madrid/madrid"
  }
]
Call itcurl · fetch · python
curl "https://postalcodes.info/search?q=madrid"
const res = await fetch("https://postalcodes.info/search?q=madrid");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://postalcodes.info/search?q=madrid")
print(res.json())

BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET

Endpoints · 6On scheduleFULL DOCS ↗
First rollup pending — GET /search?q=madrid has been probed
GET/search?q=madridPROBED

Search postal codes and places worldwide

GET/search?limit=5

Search by query parameters.

GET/search?page=1

Search by query parameters.

GET/search

Search postal codes, places or countries

GET/ajax-preview

Preview records for one country

GET/download-token.php

Mint a same-origin download token

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

PostalCodes: common questions

Is PostalCodes free to use?

Yes — PostalCodes is a free geo & maps API. Free tier: Free — limits not published. Whether the free tier allows commercial use is unclear — check the provider docs.

Does PostalCodes need an API key?

No — PostalCodes needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).

Can I call PostalCodes from the browser?

Not directly — PostalCodes doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.

Is PostalCodes up right now?

As of our last scheduled check, PostalCodes is unmonitored. We re-probe it every sweep — the status badge and uptime chart above always show the latest.