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)
Dernière mise à jour
22 octobre 2025
Limite d'appels
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%
Accès
Ouvert

Vues

Accéder à l'API
Documentation métier
Votre question porte sur autre chose que cette api ? Visiter notre forum

4 discussions dont 2 clotûrées

Comment est calculé le "score" ?

Posté le 28 octobre 2025
Dans le swagger figure un "score" dans les résultats qui semble être une évaluation (Jaro-Winkler ?) de la proximité de l'adresse demandée avec l'adresse retrouvée. Comment ce score est constituée ? A quel niveau de score peut-on considérer que l'adresse demandée est fiable (exemple : livraison possible) ?
Posté le 28 octobre 2025
Bonjour, Cela dépend du contexte métier (livraison, facturation, etc.), mais voici des repères courants : ≥ 0.95 : quasi parfait → adresse considérée comme exacte. 0.85 – 0.95 : très proche → généralement fiable pour livraison, mais vérifier si le numéro de rue est correct. 0.70 – 0.85 : correspondance approximative → risque d’erreur (ex. rue correcte mais ville différente). < 0.70 : faible → nécessite validation manuelle. Bonne journée Karim
Posté le 4 décembre 2025
Bonjour, Suite de nos travaux : il existe un paramétrage dans l'appel à l'API qui change considérablement le score et donc l'interprétation que l'on en fait. Par exemple pour une saisie "25 rue" à Villeurbanne, qui a priori ne garanti pas la livraison nous avons : - Un score de 0,52 avec autocomplete à 0 (cela correspond à un appel de type saisie "égale" ?) : https://api-adresse.data.gouv.fr/search?q=25%20rue&postcode=69100&City=Villeurbanne&autocomplete=0&index=address&limit=1&returntruegeometry=false - Un score de 0,89 avec autocomplete à 1 (cela correspond à un appel de type "commence par" ou "contient" ?) : https://api-adresse.data.gouv.fr/search?q=25%20rue&postcode=69100&City=Villeurbanne&autocomplete=1&index=address&limit=1&returntruegeometry=false 1) Manifestement, le premier choix s'impose pour fiabiliser nos livraisons. Est-ce que vous confirmez que c'est le meilleur usage de ce paramètre dans ce contexte ? 2) Existe-t-il d'autres paramètres dans l'API qui font varier le score de cette manière ? Si oui, comment les configurer afin d'obtenir un score exploitable pour fiabiliser des livraisons ?
Posté le 5 décembre 2025
Bonjour Pour fiabiliser vos livraisons avec l’API Adresse, il est important de bien comprendre l’impact des paramètres sur le score retourné. Le paramètre autocomplete joue un rôle majeur : lorsqu’il est fixé à 0, la recherche est stricte et privilégie une correspondance exacte ou très proche de la saisie. Cela permet d’obtenir un score qui reflète réellement la précision de l’adresse saisie, ce qui est essentiel pour éviter les faux positifs. À l’inverse, avec autocomplete=1, la recherche devient tolérante et complète ou corrige la saisie, ce qui peut être utile pour l’assistance à la saisie, mais présente un risque pour la validation, car le score peut être élevé même si l’adresse initiale est incomplète. Pour la validation avant livraison, il est donc recommandé d’utiliser autocomplete=0. D’autres paramètres influencent également le score. Il est conseillé de fournir une requête la plus complète possible (numéro, rue, code postal, ville) et de renseigner systématiquement le code postal et la ville pour réduire les ambiguïtés. L’index doit rester sur address afin de cibler les adresses précises, et il est préférable de limiter la réponse à un seul résultat (limit=1) pour éviter les confusions. Enfin, il est judicieux de mettre en place un seuil de score (par exemple 0,80) pour considérer une adresse comme fiable. En option, on peut utiliser la latitude et la longitude pour favoriser un match proche d’une position connue. Bonne journée Karim
Posté le 5 décembre 2025
Bonjour, Merci pour cette réponse rapide, si je résume dans les recommandations nous devons avoir : - autocomplete=0 - limit=1 - index=address Lors de nos tests nous avons eu l'impression que le paramètre : - type=housenumber Nous aidait à obtenir un score "crédible", est-ce à retenir aussi ou une illusion ?

Limite d'appels non valide

Posté le 14 octobre 2025

Qualité des resultats

Posté le 27 mai 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
Mis à jour le 28 octobre 2025
Bonjour, La recherche via le paramètre q n’interprète pas les mots comme des opérateurs booléens (AND / OR). Elle fonctionne par tokenisation et similarité (Addok). Les résultats peuvent être imprécis si la requête contient trop de mots ou des noms d’établissements (ex. « Hôpital Nord Laënnec »). Je vous recommande d'utiliser les filtres disponibles citycode (INSEE) ou postcode pour contraindre la commune. Exemple pour Saint-Herblain (code INSEE : 44162) : https://api-adresse.data.gouv.fr/search?q=boulevard%20jacques%20monod&citycode=44162&type=street&lat=47.2360&lon=-1.6403&limit=5 Bonne journée Karim

Adresses aléatoires

Posté le 5 mai 2025
Discussion close par Karim Rouane le 28 octobre 2025