Documentation de l'API INSEE pour les Communes

L'API de l'INSEE offre plusieurs points d'accès pour rechercher et récupérer des informations sur les communes françaises. Cette documentation détaille les différentes méthodes de recherche, les attributs disponibles, et les options avancées pour affiner vos requêtes.

Recherche de Communes

L'API propose plusieurs méthodes pour rechercher des communes :

Recherche par code postal : La variable codePostal permet de récupérer la liste des communes associées à un code postal.
Recherche par nom : La variable nom vous permet d’effectuer une recherche par nom. L’option boost=population vous permet de prioriser les résultats avec une plus grande population. Cette option prend tout son sens lorsque l’on recherche des communes comme Nantes par exemple. Il est possible d’utiliser la recherche par nom pour faire de l’autocomplétion.
Recherche géographique : Il est possible de faire une recherche géographique à l’aide de coordonnées. En utilisant les variables lat et lon l’API renverra la commune correspondante.

Points d'accès pour la recherche de communes :

get/communesRechercher: Pour rechercher des communes.
get/communes/{code}: Pour récupérer les informations concernant une commune spécifique.
get/epcis/{code}/communes: Renvoie les communes d’un EPCI.
get/departements/{code}/communes: Renvoie les communes d’un département.

Liste de communes par départements

/departements/[codeDepartement]/communes permet de récupérer la liste des communes associées à un département.

Exemple: 0 communes dans ce département.

Attributs de Recherche

Plusieurs attributs peuvent être utilisés pour affiner la recherche de communes :

Lire aussi: Qu'est-ce qu'une commune ? (INSEE)

codePostal: Code postal de la commune.
nom: Nom de la commune.
lat: Latitude de la commune.
lon: Longitude de la commune.

Options Avancées

L'API offre des options avancées pour personnaliser les résultats de la recherche :

fields: Le paramètre fields vous permet de filtrer les informations retournées.
format: Le paramètre format permet de préciser un format de sortie des données (json/geojson). Le format GeoJSON implique de choisir une géométrie principale. Par défaut il s’agit du centre. Cela peut être changé en ajoutant le paramètre geometry=contour.

Recherche Multicritères

Pour un utilisateur n'ayant pas le droit d'accès aux données en diffusion partielle, un contrôle est fait sur chaque variable présente dans la requête multicritères (paramètre q). Les unités légales ou les établissements pour lesquels au moins l'une de ces variables est en diffusion partielle, n'apparaîtront pas dans les résultats de la recherche.

Sélection de SIREN/SIRET

L'API permet de sélectionner les Siren (respectivement les Siret) pour lesquels une certaine variable a une valeur spécifique. Dans le cas des variables non-historisées, il s'agit toujours de la valeur courante. nomVariable doit correspondre exactement (casse comprise*) à la variable de sortie de l’interrogation unitaire.

Il est également possible de sélectionner les Siren (respectivement les Siret) pour lesquels une certaine variable a une valeur spécifique sur au moins une période**. Dans le cas des variables historisées, on peut obtenir leur valeur courante ou la valeur qu'elles ont eue depuis la création de l'unité légale (respectivement l'établissement). nomVariable doit correspondre exactement (casse comprise*) à la variable de sortie de l’interrogation unitaire.

Toutes les variables peuvent être utilisées, y compris les indicatrices, avec quelques subtilités pour les variables au format date.

Lire aussi: Montpellier : Code INSEE et données

(**) Une période au sens de l'API est un intervalle de temps durant lequel aucune variable historisée n'a été modifiée.

(1) 33.01 appartenant à une ancienne nomenclature, une unité légale (resp.