API Adresse (Base Adresse Nationale - BAN)

L' API Adresse permet d'interroger facilement la Base Adresse Nationale.

A quoi sert l'API Adresse ?

En intégrant l'API dans votre système d'information, vous pouvez facilement rechercher une adresse et :

  • faire de l'autocomplétion et de la vérification d'adresse ;
  • géolocaliser une adresse sur une carte ;
  • faire une recherche géographique inversée (trouver la rue la plus proche de coordonnées géographiques).

Données disponibles

NomDescription
typetype de résultat trouvé : rue, numéro de plaque, lieu-dit, commune
numéro de plaquenuméro avec indice de répétition éventuel (bis, ter, A, B)
nomnuméro éventuel et nom de voie ou lieu dit
code postalcode postal
code de villecode INSEE de la commune
communenom de la commune
arrondissementnom de l’arrondissement (Paris/Lyon/Marseille)
contextn° de département, nom de département et de région

En savoir plus

La Base Adresse Nationale est constituée par la collaboration entre:

  • des acteurs nationaux tels que la DINUM, l’IGN et l’ANCT,
  • des acteurs locaux tels que les collectivités et en particulier les communes qui ont la compétence de l’adressage.

Lien des documentations supplémentaires

Partenaires de l'API

  • IGN
  • Agence nationale de cohésion des territoires (ANCT)
Contact
Last update
28 de abril de 2025
Rate limiting
50 appels / seconde / IP L'API unitaire est disponible à hauteur de 50 appels par seconde et par adresse IP. Le géocodage de masse (CSV) est disponible à hauteur d'un appel simultané par adresse IP.
Taux de disponibilité
100%
Access
Open

2 discussions

Qualité des resultats

Posted the 27 de mayo de 2025
Bonjour, Pour les besoins d'une application, je cherche à récupérer les données adresses pour une saisie propre de ces adresses dans l'application ainsi que leurs coordonnées GPS. La saisie étant ponctuelle et selon les activités de l'utilisateur, j'utilise l'api en ligne pour rechercher , lister et sélectionner la bonne adresse. Par exemple, j'ai voulu rechercher l'adresse de l'Hôpital Nord Laennec de Nantes, qui se trouve à Saint-Herblain. La qualité des résultats est trop faible, ou l'api est elle trop limitée ? peut on avoir une recherche en 'OR' ou 'AND'. avec la requête https://api-adresse.data.gouv.fr/search/?q=boulevard+jacques+monod+saint+herblain , donc un recherche plutôt précise, il faut choisir entre des réponses sur Saint Herblain ou des adresses sur des Boulevard, et avec un peu de chance des Jacques Monod, mais pas le tout ensemble. Comment se fait le scoring sur l'affichage des resultats ? Pire encore : si je fais la recherche https://api-adresse.data.gouv.fr/search/?q=monod+saint+herblain , il y a très peu de retour d'adresse, mais aucune ne se trouve à saint herblain ! En l'état ce service est inutilisable. La version image docker utilise t elle la même api ? Cordialement

Adresses aléatoires

Posted the 5 de mayo de 2025
Bonjour, peux tu me récolter aléatoirement des adresses en fonction des codes postaux que je te donne ?