Use Case
Vérification d'adresses françaises
Validez et corrigez des adresses françaises en temps réel.
Basé sur la Base Adresse Nationale (BAN), l'API retourne une adresse validée avec un score de confiance.
Particulièrement adapté quand l'autocomplétion n'est pas utilisable — saisie hors formulaire, intégration dans un script ou un pipeline ETL.
Pourquoi c'est compliqué
- Fautes de frappe et abréviations (« av. » vs « avenue ») polluent vos bases
- Adresses en doublon empêchent la déduplication fiable
- Codes postaux ou communes erronés causent des échecs de livraison
- Format non normalisé empêche les analyses géographiques
- Pas de retour en temps réel lors de la saisie utilisateur
Ce que fait TrustyData
- Données issues du référentiel BAN officiel (IGN)
- Correction orthographique tolérante aux fautes de frappe
- Retour du code INSEE et du code postal
- Nom de la commune (INSEE et libellé d'acheminement)
- Score de confiance de 0 à 1 pour chaque résultat
- Couverture nationale complète, données mises à jour mensuellement
Démo API
Exemple de requête / réponse
Une simple requête GET suffit. Réponse JSON en quelques millisecondes.
La quantité d'informations renvoyée dépend du plan souscrit.
GET /v1/address/verify
?q=10+rue+paix+75+paris&limit=1
{
"status": "OK",
"message": "",
"matches": [
{
"score": 0.95,
"verdict": "match_exact",
"adresse": "10 Rue de la Paix, 75002 Paris 2e Arrondissement",
"id": "81a4b089-2c83-446e-b35c-50c88cdd6064",
"numero": "10",
"rep": "",
"nom_voie": "Rue de la Paix",
"code_postal": "75002",
"nom_commune": "Paris 2e Arrondissement",
"code_insee": "75102",
"id_fantoir": "75102_6998",
"code_insee_ancienne_commune": "",
"nom_ancienne_commune": "",
"nom_ld": "",
"libelle_acheminement": "PARIS",
"nom_afnor": "RUE DE LA PAIX",
"source_position": "commune",
"certification_commune": true,
"cad_parcelles": null,
"id_ban": "75102_6998_00010",
"position": {
"lat": 48.868989,
"lon": 2.33115,
"x": 650936.23,
"y": 6863425.69,
"type_position": "parcelle"
},
"geocoding": {
"iris": "0502",
"code_iris": "751020502",
"nom_iris": "Gaillon 2",
"type_iris": "A"
},
"statistical_grid": {
"id_inspire": "CRS3035RES200mN2891000E3759200",
"id_carr1km": "CRS3035RES1000mN2891000E3759000",
"i_est_cr": 0,
"id_carr_n": "CRS3035RES1000mN2891000E3759000",
"groupe": 862270,
"depcom": "75102",
"i_pauv": 0,
"id_car2010": "CRS3035RES200mN2891000E3759200",
"ind": 111,
"men": 60,
"men_pauv": 9,
"men_1ind": 33,
"men_5ind": 4,
"men_prop": 11,
"men_fmp": 5,
"ind_snv": 4489210.7,
"men_surf": 3794,
"men_coll": 60,
"men_mais": 0,
"log_av45": 49,
"log_45_70": 0,
"log_70_90": 0,
"log_ap90": 11,
"log_inc": 0,
"log_soc": 0,
"ind_0_3": 3,
"ind_4_5": 0,
"ind_6_10": 6,
"ind_11_17": 9,
"ind_18_24": 2,
"ind_25_39": 27,
"ind_40_54": 30,
"ind_55_64": 9,
"ind_65_79": 16,
"ind_80p": 7,
"ind_inc": 2,
"i_est_1km": 0
}
}
]
}
Données fournies
Champs retournés par l'API
Les champs retournés dépendent du plan souscrit.
Cas d'usage
Secteurs qui utilisent la vérification d'adresses
E-commerce & Logistique
Réduire les colis non livrés
Le taux de PND courrier (anciennement NPAI) atteint en moyenne 4 % des envois (source La Poste). Validez l'adresse au moment de la commande pour intercepter ces envois perdus avant l'expédition.
Assurance & Finance
Fiabiliser la souscription en ligne
Normalisez l'adresse lors de l'inscription pour garantir la cohérence des dossiers et faciliter la vérification d'éligibilité géographique.
Marketing & CRM
Dédupliquer votre base clients
Normalisez toutes les adresses de votre base pour identifier les doublons cachés par des variantes orthographiques. Améliorez vos taux de délivrabilité courrier.
Périmètre
Validation BAN : ce que TrustyData fait (et ne fait pas)
La validation d'adresses proposée par TrustyData repose sur la Base Adresse Nationale (BAN), référentiel géographique officiel produit par l'IGN, La Poste et les communes françaises. Ce positionnement apporte des avantages concrets pour la qualité des données géographiques : correction d'adresses tolérante aux fautes, retour de coordonnées GPS, prise en charge du complément adresse (lieu-dit, résidence), et validation en temps réel lors de la saisie d'adresses dans vos formulaires.
En revanche, TrustyData n'est pas un outil de normalisation d'adresses au sens postal du terme. La normalisation postale homologuée par La Poste (process RNVP) s'appuie sur des référentiels propriétaires incluant les adresses CEDEX, les boîtes postales et les codes d'acheminement spécifiques aux entreprises. Ces données ne sont pas présentes dans la BAN. Si votre besoin est d'imprimer des étiquettes conformes aux exigences de La Poste ou de gérer des adresses CEDEX en masse, un prestataire disposant de logiciels certifiés AFNOR NF Z 10-011 est plus adapté.
Pour tous les autres cas — enrichissement géographique, nettoyage des données d'une base CRM, géocodage, déduplication, analyse de zone — TrustyData couvre l'essentiel du territoire à partir de sources open data officielles et mises à jour mensuellement.
Formules
Quel plan pour la vérification d'adresses ?
Disponible dès le plan Discovery gratuit. Passez à un plan supérieur pour un quota plus élevé.
- ✓ Plan gratuit
- ✓ Vérification unitaire
- ✓ Autocomplétion de communes
- ✓ Autocomplétion d'adresses
- ✓ Score de confiance
- ✓ Vérification unitaire
- ✓ Géocodage GPS
- ✓ Géocodage inverse
FAQ
Questions fréquentes
-
Comment fonctionne la vérification d'adresses TrustyData ?
L'API compare l'adresse saisie avec la Base Adresse Nationale (BAN), référentiel officiel français. Elle retourne l'adresse validée, un score de confiance, les coordonnées GPS ainsi que les informations nécessaires à la distribution postale. -
Quelle est la source des données utilisées ?
TrustyData s'appuie sur la Base Adresse Nationale (BAN), le référentiel Datanova de La Poste, ainsi que des données de l'IGN et des communes françaises. La couverture inclut le territoire métropolitain et l'Outre-mer. -
L'API gère-t-elle les adresses CEDEX et boîtes postales ?
Les codes CEDEX sont spécifiques à La Poste et absents des référentiels BAN et Datanova utilisés par TrustyData. De plus, un CEDEX est une adresse de distribution qui ne correspond pas à une adresse physique. Par conséquent, il n'est pas possible d'affecter les coordonnées GPS à ces adresses. -
Quel verdict et quel score retourne l'API, et comment les interpréter ?
L'API retourne pour chaque candidat un verdict d'identité calculé par son analyseur d'adresses NLP, accompagné d'un score de 0 à 1.match_exactsignifie que le candidat est très probablement la même adresse que la requête ;match_probableindique une correspondance plausible mais avec un doute. Quand aucun candidat ne passe les filtres, l'API renvoieno_results(liste vide). Le verdict pilote la décision automatique ; le score sert à ordonner les candidats à présenter à un opérateur en revue manuelle. -
TrustyData remplace-t-il Pages Blanches, Pages Jaunes ou un annuaire inversé ?
Non. Pages Blanches et Pages Jaunes sont des annuaires de personnes et d'établissements ; un annuaire inversé permet de retrouver un nom à partir d'un numéro de téléphone. TrustyData est un service de validation d'adresses postales : il vérifie qu'une adresse existe géographiquement, retourne ses coordonnées GPS et enrichit vos données avec les référentiels INSEE. Ce sont des usages complémentaires, non substituables. -
Comment utiliser TrustyData pour la mise à jour d'adresses en base ?
Passez chaque adresse postale de votre base en paramètreqde l'endpoint/v1/address/verify. La décision automatique se lit directement dans la réponse : un seul candidat avec verdictmatch_exact→ mise à jour automatique fiable ; plusieurs candidats ou verdictmatch_probable→ file de revue manuelle ;no_results→ file de rejet. Ce flux s'intègre facilement dans un pipeline Python et constitue le premier niveau d'un programme de qualité des données sur vos bases clients ou prospects.
Prêt à nettoyer vos adresses ?
Disponible gratuitement dès le plan Discovery. Aucune carte bancaire requise.
Services liés