API — CodePostalPro

L’API sert le même jeu de données que ce site — 100 373 localités aux États-Unis, en France, en Algérie, en Tunisie et au Maroc — en JSON, depuis https://api.codepostalpro.com. Elle est en lecture seule, compatible CORS et sans clé jusqu’à 1 000 requêtes par jour et par IP. Chaque fiche porte ses sources et un statut verification, pour pouvoir être citée et non seulement utilisée.

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/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, list_countries.

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.