BETA

Compatible avec geo.api.gouv.fr

Geodata

Les régions, départements, communes et EPCI de France, avec leurs codes postaux, leur population et leurs contours : mêmes chemins, mêmes paramètres, même JSON que geo.api.gouv.fr.

Changez l'URL de base, gardez votre code

- https://geo.api.gouv.fr/communes?nom=metz&fields=nom,code,codesPostaux
+ https://api.wymmo.dev/geodata/communes?nom=metz&fields=nom,code,codesPostaux

Ce que fait l'API

Geodata répond sur le découpage administratif de la France : les régions, les départements, les communes, les EPCI à fiscalité propre et les communes associées ou déléguées. Une commune se cherche par son nom, son code Insee, son code postal ou un point qu'elle contient, et vient avec sa population, ses codes postaux, son centre et son contour.

Compatible avec geo.api.gouv.fr

Les chemins, les paramètres et le JSON sont ceux de geo.api.gouv.fr. Pour migrer, vous changez l'URL de base ; votre code, vos filtres et la lecture des réponses restent les mêmes.

Essayez

0 commune
Exemples :

La comparaison interroge aussi geo.api.gouv.fr depuis votre navigateur : il reçoit votre adresse IP et le texte saisi. wymmo.dev n'est pas affilié à ce service.

wymmo.dev
—
geo.api.gouv.fr
—

Temps mesurés depuis votre navigateur, réseau compris.

Tapez ou choisissez un exemple : la même requête part vers les deux API.

Les routes

MéthodeCheminCe qu'elle répond
GET/regionsLes régions, par code, nom ou zone
GET/regions/{code}Une région
GET/regions/{code}/departementsLes départements d'une région
GET/departementsLes départements, par code, nom, région ou zone
GET/departements/{code}Un département
GET/departements/{code}/communesLes communes d'un département
GET/communesLes communes, par code, nom, code postal, point, département ou EPCI
GET/communes/{code}Une commune
GET/epcisLes EPCI à fiscalité propre, par code, nom, département ou région
GET/epcis/{code}Un EPCI
GET/epcis/{code}/communesLes communes membres d'un EPCI
GET/communes_associees_delegueesLes communes associées et déléguées, anciennes communes fusionnées
GET/communes_associees_deleguees/{code}Une commune associée ou déléguée

Caractéristiques

  • La recherche par nom classe les réponses par pertinence, ou par population avec boost=population
  • Les contours, le centre, la mairie ou l'emprise de chaque commune, en GeoJSON avec format=geojson
  • La métropole, les départements et régions d'outre-mer, les collectivités d'outre-mer (zone)
  • Les champs de la réponse au choix (fields)
  • Appelable depuis n'importe quel site, dans le navigateur de vos visiteurs (CORS ouvert)

Performances

Drop-in, blazingly fast geodata

Pensées dès le premier jour pour la vitesse : des réponses quasi instantanées, qui le restent quand les requêtes s'enchaînent.

Mesurez vous-même : la démo prend les temps de réponse dans votre navigateur, chez nous et chez l'État.

Démarrage rapide

Premières requêtes

Sans compte ni clé : l'URL suffit.

curl 'https://api.wymmo.dev/geodata/communes?nom=roche&boost=population&limit=5'
curl 'https://api.wymmo.dev/geodata/communes?codePostal=57000&fields=nom,code,population'
curl 'https://api.wymmo.dev/geodata/communes?lat=49.12&lon=6.17&fields=nom,code,codesPostaux&format=geojson&geometry=contour'
curl 'https://api.wymmo.dev/geodata/departements/57/communes?fields=nom,code,departement,region&limit=50'
curl 'https://api.wymmo.dev/geodata/epcis?nom=metz&fields=nom,code,population'

Migrer depuis geo.api.gouv.fr

Chez l'ÉtatChez wymmo.dev
https://geo.api.gouv.fr/communes?…https://api.wymmo.dev/geodata/communes?…
/regions, /departements, /epcis, /communes_associees_delegueesles mêmes chemins, sous https://api.wymmo.dev/geodata

Écarts connus

Pas encore servi : les fichiers /raw/*.json et les réponses 304 (ETag).

Répond autrement, exprès :

  • une liste en GeoJSON, ou avec le champ contour, demande un critère autre que type, zone ou boost : sans lui, elle répond 400 plutôt que les 300 Mo de tous les contours ;
  • lat, lon et limit non numériques répondent 400 au lieu d'être ignorés ;
  • le GeoJSON est servi en application/geo+json ;
  • nom=Paris met Paris en tête, comme nom=paris ;
  • l'ordre des membres d'un objet JSON suit la spec plutôt que fields, et _score peut valoir 1.0 là où l'État écrit 1 : la même valeur une fois relue.

L'offre

L'API est ouverte pendant son lancement, sans compte ni clé. Rien ne sera facturé sans que vous ayez souscrit une offre.

Voir les tarifs

Licences des données

Sources

DonnéesProducteurÉdition servieLicenceSert à
Code officiel géographique et populations légalesInsee, mis en forme par Etalab (@etalab/decoupage-administratif 6.0.0)2026Licence Ouverte 2.0les régions, départements et communes
Liste des EPCI à fiscalité propreDGCL, par le même paquet2026Licence Ouverteles EPCI et leurs communes
Base officielle des codes postauxLa Poste, par le même paquetcelle du paquet 6.0.0Licence Ouverte 2.0les codes postaux, la recherche par code postal
Contours administratifs des communes et des EPCI, mairiesIGN (ADMIN EXPRESS 4.0 du 19 janvier 2026), généralisés par Etalab2026Licence Ouverte 2.0les contours, centres, mairies et emprises, la recherche par point, en métropole et dans les départements d'outre-mer
Contours des communes de Saint-Pierre-et-Miquelon (975), Saint-Barthélemy (977), Saint-Martin (978), des Terres australes et antarctiques françaises (984), de Wallis-et-Futuna (986) et de Clipperton (989)les contributeurs d'OpenStreetMap, extraits par Etalab1er janvier 2022ODbL 1.0les contours, centres et emprises de ces communes
Contours des communes de Polynésie française (987)Section Cadastre-Topographie de la Polynésie française, par Etalab1er janvier 2022non vérifiée à la source : CC-BY selon data.gouv.fr, Licence Ouverte selon Etalables contours, centres et emprises de ces communes
Contours des communes de Nouvelle-Calédonie (988)Gouvernement de la Nouvelle-Calédonie, par Etalab1er janvier 2022non vérifiée à la source : Licence Ouverte selon Etalables contours, centres et emprises de ces communes
Mairies de six communes « mortes pour la France » (leur mémorial)les contributeurs d'OpenStreetMap, par Etalab2026ODbL 1.0la mairie de ces six communes

Ces données sont publiques : wymmo.dev les sert plus vite, il ne les produit pas et ne les corrige pas.

Les contours d'outre-mer

Hors des départements d'outre-mer, ADMIN EXPRESS ne couvre pas les collectivités d'outre-mer : Etalab complète leurs contours avec d'autres sources, que geodata sert telles quelles.

  • Saint-Pierre-et-Miquelon, Saint-Barthélemy, Saint-Martin, les Terres australes et antarctiques françaises, Wallis-et-Futuna et Clipperton : contours extraits d'OpenStreetMap par une requête Overpass, dans un fichier daté du 1er janvier 2022, sous licence ODbL 1.0. La mention due est « © les contributeurs d'OpenStreetMap », avec un lien vers openstreetmap.org/copyright.
  • Polynésie française : contours des services de la Polynésie française ; data.gouv.fr indique CC-BY, le dépôt d'Etalab la Licence Ouverte. La licence n'est pas vérifiée à la source.
  • Nouvelle-Calédonie : contours du gouvernement de la Nouvelle-Calédonie, sous Licence Ouverte selon le dépôt d'Etalab. La licence n'est pas vérifiée à la source.
  • Six communes mortes pour la France : leur mairie est le point de leur mémorial dans OpenStreetMap, sous ODbL 1.0.

L'ODbL a une clause de partage à l'identique que la Licence Ouverte n'a pas : si vous rediffusez les contours de ces communes, lisez-la avant. Les réponses de l'API ne portent aucune mention : ces communes se reconnaissent à leur code, qui commence par 975, 977, 978, 984, 986, 987, 988 ou 989.

Mention à reprendre

Si vous rediffusez des résultats de geodata, la Licence Ouverte vous demande de citer la source et sa date de mise à jour. Reprenez les lignes des données que vous utilisez :

  • Source : Insee — Code officiel géographique 2026
  • Source : La Poste — Base officielle des codes postaux
  • Source : IGN — ADMIN EXPRESS 4.0, édition du 19 janvier 2026, contours généralisés par Etalab — Licence Ouverte 2.0
  • Pour les communes 975, 977, 978, 984, 986 et 989, et les six mémoriaux : © les contributeurs d'OpenStreetMap — ODbL 1.0

Toutes les sources et leurs licences

Référence

Chaque route, chaque paramètre et chaque réponse, à essayer en ligne : la référence de l'API.

Sa spec OpenAPI : https://api.wymmo.dev/geodata/openapi.yaml

wymmo.dev est un service indépendant, sans lien avec l'IGN, Etalab ni l'administration. Les données viennent de sources publiques : voir leurs licences.