API — CodePostalPro

L’API sert deux niveaux en JSON depuis https://api.codepostalpro.com. Le niveau curated est le jeu de données du site — 100 373 localités aux États-Unis, en France, en Algérie, en Tunisie et au Maroc, recoupées. Le niveau bulk ajoute 1,7 million de codes postaux pour ~115 autres pays (GB, DE, CA, IN, JP, MX, BR…) via GeoNames — lieu, zones administratives et coordonnées, marqués tier: "bulk". Lecture seule, compatible CORS, sans clé jusqu’à 1 000 requêtes par jour et par IP. Chaque fiche porte ses sources, son statut verification et son niveau.

Essayer

curl https://api.codepostalpro.com/v1/postal/FR/29200

Points d’accès

Point d’accès	Renvoie
`GET /v1`	Index, date des données et effectifs
`GET /v1/countries`	Pays, formats de codes, libellés de hiérarchie, repères
`GET /v1/postal/{country}/{code}`	Toutes les localités portant un code postal
`GET /v1/search?q=&country=&limit=`	Recherche par nom ou début de code
`GET /v1/nearby?lat=&lon=&radius_km=&country=&limit=`	Localités autour d’un point, avec distance
`GET /v1/areacodes/{npa}`	Indicatif téléphonique US → États, villes, nombre de ZIP et indicatifs superposés
`GET /v1/whereami`	Localisation réseau de l’appelant et localités proches (jamais mise en cache)
`GET /v1/geocode?address=`	Adresse postale US → ZIP + fiche complète (géocodeur Census TIGER ; adresse jamais conservée)
`GET /v1/regions/{country}/{region}`	Un État, une région ou une wilaya avec ses villes / départements
`GET /v1/groups/{country}/{region}/{group}`	Une ville, un département ou une délégation avec ses localités
`GET /v1/localities/{country}/{region}/{group}/{locality}`	Une fiche de localité

{country} accepte un code ISO (FR, DZ) ou le slug du site (france, algerie). Les slugs de régions, groupes et localités sont ceux des URL de ce site.

Champs utiles

verification — cross-checked, source-single, conflict ou unverified. En cas de conflict, alternate_codes liste les autres valeurs avec leur source ; aucune n’est choisie en silence.
time_zone — zone IANA du lieu habité le plus proche ; les décalages par pays sont dans /v1/countries.

Clés et limites

Anonyme : 1 000 requêtes/jour par IP. Clé gratuite : 5 000/jour, obtenue en une requête — POST https://api.codepostalpro.com/v1/keys {"email":"[email protected]"} — à envoyer ensuite en X-Api-Key. Plan Pro (100 000/jour) sur demande.

Pour les agents IA — serveur MCP

Les mêmes données sont exposées comme serveur MCP à https://api.codepostalpro.com/mcp (Streamable HTTP, sans session). Outils : lookup_postal_code, search_places, nearby_places, get_region, get_group, area_code_lookup, list_countries. Le serveur est référencé dans le registre MCP officiel sous com.codepostalpro/postal-codes (espace de noms vérifié par domaine).

Conditions

Les données sont redistribuées sous les licences de leurs sources (GeoNames CC BY 4.0 notamment) : l’attribution aux sources et à CodePostalPro comme compilateur est requise. Voir les sources.