Geocoding · head-to-head
API Découpage Administratif (API Geo) vs Nominatim
Etalab's Découpage Administratif API looks up and cross-references France's administrative hierarchy — communes, EPCIs, départements, and régions — by name, postcode, SIREN, or geographic coordinates, with no API key required. The stored api.gouv.fr/api/geoapi.html link had gone stale, 301-redirecting to a generic data.gouv.fr listing page instead of the live docs; the real service and interactive documentation are hosted at geo.api.gouv.fr. A live Origin-header probe against the real /communes endpoint confirms open CORS, reflecting back whatever Origin is sent.
Nominatim provides worldwide forward and reverse geocoding built entirely on OpenStreetMap data, needing no API key — only a descriptive User-Agent or Referer header identifying the calling application. The public instance at nominatim.openstreetmap.org is a free courtesy service, not a commercial product: its usage policy caps requests at 1 per second, forbids autocomplete-style querying and bulk/parallel scripts, and requires caching results rather than re-fetching them. Heavier users are expected to self-host Nominatim against their own OSM extract instead of relying on the shared instance.
| API Découpage Administratif (API Geo) | Nominatim | |
|---|---|---|
| Authentication | None | None |
| Pricing | free | free |
| Formats | JSON, GeoJSON | JSON, XML, GeoJSON |
| CORS | yes | yes |
| HTTPS | Yes | Yes |
Nominatim supports 3 response formats, while API Découpage Administratif (API Geo) offers fewer — pick Nominatim for more integration flexibility.