# TrustyData > API REST de qualite de donnees francaises — adresses, entreprises et zones de chalandise — basee sur l'open data officiel (BAN, INSEE, SIRENE, RNE, BODACC, OpenStreetMap). Site web : https://trustydata.fr Documentation detaillee : https://trustydata.fr/llms-full.txt ## Presentation TrustyData est une API REST francaise qui permet de verifier, valider, geolocaliser et enrichir des adresses postales francaises, et de rechercher les entreprises et etablissements francais dans la base SIRENE (INSEE), enrichie des dirigeants du Registre national des entreprises (INPI) et des procedures collectives du BODACC. Toutes les donnees proviennent de sources open data officielles (BAN, INSEE, IGN, La Poste). L'API est aussi accessible via un serveur MCP (Model Context Protocol) pour une utilisation en langage naturel depuis Claude, ChatGPT ou tout client compatible. Elle trace aussi la zone de chalandise reelle d'un point de vente (isochrone en temps de trajet, pas un cercle), la chiffre sur les donnees INSEE (population, menages, niveau de vie moyen, profil par ages et par CSP, potentiel de depense, prix de vente immobiliers DVF sur cinq ans) et compare jusqu'a dix emplacements en mesurant leur cannibalisation ; le meme calcul est accessible depuis la demo publique, l'API et le serveur MCP. TrustyData est concu par Herve Tristram, 25 ans d'experience en qualite de donnees acquise au sein de grandes organisations francaises (medias publics, ETI, institutions publiques). ## Differenciateurs - 100% open data francais (BAN/IGN, INSEE/COG, IRIS Filosofi, Carroyage 200m, Datanova La Poste, OpenStreetMap, SIRENE/INSEE, RNE/INPI, BODACC) - Souverainete : donnees hebergees en France (OVH SAS), aucune sortie de l'UE - Aucun stockage des adresses : traitement en memoire uniquement - Tarifs predictibles : overage transparent au volume depasse, jamais de coupure de service - Plan gratuit Discovery : 20 000 requetes/mois, duree illimitee, sans carte bancaire - API REST classique + serveur MCP natif pour LLMs (Claude, ChatGPT, clients compatibles) - Couverture nationale : 34 900 communes, 26 millions d'adresses BAN, 15 500 zones IRIS, 2,3 millions de carreaux INSEE 200m, 43 millions d'etablissements SIRENE, 29,7 millions d'entreprises Compare a `api-adresse.data.gouv.fr` (gratuit, IGN), TrustyData ajoute le scoring de confiance, l'enrichissement IRIS et carroyage INSEE 200m, l'autocompletion de communes, le serveur MCP, et un SLA contractuel que l'API publique n'offre pas. Compare a Google Geocoding API, TrustyData est 5 a 10 fois moins cher au volume, repose sur des donnees 100% francaises et garantit qu'aucune donnee ne quitte l'UE. ## Services ### Verification d'adresses Valide et normalise une adresse francaise. Retourne l'adresse corrigee, un score de confiance (0-1), le code postal, le code INSEE, le code FANTOIR et le libelle d'acheminement. - Endpoint : `POST /services/v1/address/verify` (body JSON : `{"q": "", "max_results": }`) - Disponible : tous les plans - Page : https://trustydata.fr/usecases/verification-adresses - Guide : https://trustydata.fr/docs/adresses.html ### Geocodage Convertit une adresse en coordonnees GPS (WGS84 latitude/longitude + Lambert 93 EPSG:2154). Precision au numero de voie quand disponible. - Endpoint : `POST /services/v1/address/verify` (body JSON : `{"q": ""}`) - Disponible : a partir du plan Starter - Page : https://trustydata.fr/usecases/coordonnees-gps-wgs84 - Guide : https://trustydata.fr/docs/adresses.html ### Geocodage IRIS et carroyage INSEE Enrichit une adresse avec le code IRIS (9 chiffres, decoupe infra-communale INSEE), le type de quartier (Habitat/Activite/Divers) et les indicateurs socio-demographiques du carroyage 200m INSEE (population, menages, revenus, logements, tranches d'age). - Endpoint : identique a la verification - IRIS disponible : a partir du plan Growth - Carroyage 200m : plan Business uniquement - Page : https://trustydata.fr/usecases/geocodage-statistique-iris - Guide : https://trustydata.fr/docs/adresses.html ### Recherche de proximite Trouve les adresses de la BAN dans un rayon donne autour d'un point central (coordonnees GPS ou adresse libre). Resultats tries par distance croissante, avec distance_m par adresse. - Endpoint : `GET /v1/address/proximity?adresse=&rayon=&limit=` (ou `lat=&lon=` au lieu de `adresse`) - Rayon : en metres, 50 km max. Pagination : limit 100 par defaut, 200 max ; suivre pagination.next_offset (jusqu'a 5000 adresses parcourables). - Disponible : des le plan Growth (le plan Business ajoute la grille statistique INSEE Filosofi par adresse). Non inclus dans Discovery et Starter. - Page : https://trustydata.fr/usecases/recherche-proximite - Guide : https://trustydata.fr/docs/adresses.html ### Recherche de points de vente (Mes lieux) Recherche du site le plus proche dans le referentiel de lieux propre a un compte client (boutiques, restaurants, agences) — jamais dans un referentiel public. Chaque site est geocode automatiquement (BAN) apres son chargement. - Endpoint : `GET /services/v1/locations/search` (rayon en kilometres, 1 a 50) - Filtre par etiquettes : a partir du plan Growth - Capacite incluse par palier : 200 sites (Starter), 2 000 (Growth), 10 000 (Business) — aucune facturation au site - Page : https://trustydata.fr/usecases/point-de-vente-le-plus-proche - Demo : https://trustydata.fr/demo/locations-search ### Zone de chalandise (Mes lieux) Calcule l'aire reellement atteignable depuis un point de vente, en temps de trajet (voiture, velo, a pied), sur le referentiel de sites du compte. Rend le contour GeoJSON et les sites qu'il contient. La population, les menages et le niveau de vie moyen de la zone viennent d'un second appel, `POST /services/v1/zone/stats` (ci-dessous) ; l'enrichissement fin (IRIS, carreau Filosofi) se fait par adresse. - Endpoint : `GET /services/v1/locations/search?referentiel=&adresse=&duree=<1-30>&mode=&polygone=true` - Disponible : Growth et Business (duree/mode/polygone) ; code IRIS par adresse des Growth ; carreau Filosofi en Business - Circulation : `circulation=fluide` (defaut, circulation libre) ou `circulation=pointe` (heure de pointe du matin, vitesses typiques modelisees — jamais du trafic temps reel), en voiture seulement - Guide : https://trustydata.fr/docs/zone-de-chalandise.html#circulation - Page : https://trustydata.fr/usecases/zone-de-chalandise - Guide : https://trustydata.fr/docs/zone-de-chalandise.html ### Statistiques INSEE d'une zone Population, menages, menages sous le seuil de pauvrete, niveau de vie moyen par personne et nombre d'IRIS couverts d'une zone, et depuis septembre 2026 le profil de la zone en trois blocs `ages` (onze tranches d'age INSEE), `menages_profil` (personnes seules, 5 personnes et plus, proprietaires, monoparentaux, collectif/maison, surface moyenne) et `logements` (periodes de construction, sociaux), chacun en `{effectif, part}` — part en % au dixieme, calculee avant arrondi, rapportee a la population, aux menages ou au total des logements ; un bloc `sexe` — `hommes` et `femmes` en `{effectif, part}` plus `population_recensement` (hommes + femmes, la population du recensement repartie sur la zone, denominateur des parts, distinct de `population`), une estimation par repartition des donnees IRIS ; et un bloc `csp` — huit categories socioprofessionnelles des 15 ans et plus en `{effectif, part, indice}`, l'indice valant 100 x part de la zone / part de la France (ou du departement dominant avec `reference=departement`), plus `fiabilite {population_15_plus, part_iris_communaux, indices_fiables}`. Les CSP sont une estimation : diffusees par l'INSEE a l'IRIS seulement (recensement 2022), reparties sur les carreaux au prorata de leur population de 15 ans et plus ; sous 1 000 personnes `indices_fiables` est faux et l'indice ne dit rien de plus que le quartier. Et un bloc `potentiel_depense` : unites de consommation reconstituees, `revenu_disponible_estime` (euros par an) et `revenu_disponible_par_menage`, plus `potentiel_theorique` = revenu x `coefficient` (parametre de requete 0 exclu a 1, jamais transmis a l'amont) — une estimation (niveau de vie ecrete, revenus 2021, UC reconstituees), pas une prevision de chiffre d'affaires ; table de reperes par fonction de consommation dans le guide — decrite par une duree de trajet (1 a 30 min, voiture/velo/pied), un rayon (1 a 50 km) ou un contour GeoJSON. Et un bloc `immobilier` (depuis septembre 2026) : pour `maisons`, `appartements` et `locaux_activite`, par annee sur cinq ans, `ventes` et `prix_m2_median` (prix de vente declare, euros par m2 de surface reelle batie — jamais un loyer) compares au departement (`reference_prix_m2_median`, `reference {code, libelle}`), `evolution_pct` entre la premiere et la derniere annee fiables et `indice` (100 = le departement) ; sous 20 ventes dans l'annee le prix vaut null ; `hors_couverture` pour l'Alsace-Moselle et Mayotte (les DROM 971-974 sont couverts). Source DGFiP DVF, retraitement Etalab. Sommes des carreaux INSEE Filosofi 200 m ponderees par la part de surface de chaque carreau dans la zone ; la reponse dit combien de carreaux sont imputes par l'INSEE (secret statistique — la norme, pas un defaut). Plafond 10 000 km2. Zone vide = 200 avec des zeros. - Endpoint : `POST /services/v1/zone/stats` (corps JSON : `{"adresse": "...", "duree": 15, "mode": "auto"}` ou `{"lat", "lon", "rayon"}` ou `{"polygone": }` ; avec `duree`, accepte aussi `"circulation": "pointe"` pour l'heure de pointe du matin) - Disponible : Growth et Business ; un appel compte quelle que soit la portee - Attribution obligatoire avec tout chiffre affiche : `attribution` (INSEE Filosofi + IGN Contours IRIS, millesimes compris ; DGFiP DVF pour les prix immobiliers ; OpenStreetMap en portee isochrone) - Page : https://trustydata.fr/usecases/zone-de-chalandise - Demo : https://trustydata.fr/demo/zone-de-chalandise - Guide : https://trustydata.fr/docs/zone-de-chalandise.html#stats ### Comparaison multi-zones et cannibalisation - Comparaison multi-zones : `POST /services/v1/zone/compare` (corps JSON `{"zones": [2 a 10 zones, chacune comme /zone/stats + "id" optionnel], "reference", "coefficient", "critere"}`) — chaque zone rend le bloc complet de /zone/stats plus `exclusif` (population, menages et potentiel que la zone est seule a couvrir, hors de tout chevauchement avec les autres zones de la requete ; calcule comme zone moins l'union des autres, pas comme total moins paires) ; `chevauchements` par paire de zones qui se recouvrent (population, menages, potentiel comptes deux fois) ; `classement` des identifiants sur `critere` (population, population_exclusive, potentiel_theorique, potentiel_exclusif). Un appel compte quel que soit le nombre de zones. Growth et Business. ### Autocompletion d'adresse Suggestions d'adresses en temps reel avec tolerance aux fautes de frappe. Temps de reponse < 30 ms. Base de 26 millions d'adresses (BAN). - Endpoint : `GET /v1/address/autocomplete?q=&limit=` - Disponible : tous les plans - Page : https://trustydata.fr/usecases/autocompletion-adresse - Guide : https://trustydata.fr/docs/adresses.html ### Autocompletion de communes Recherche intelligente sur 35 000 communes francaises par nom ou code postal. Retourne le code INSEE, le code postal, le departement, la region, la population et la superficie. - Endpoint : autocompletion communes - Disponible : tous les plans - Page : https://trustydata.fr/usecases/autocompletion-communes - Guide : https://trustydata.fr/docs/communes.html ### Itineraires et matrice de distances Calcul d'itineraires routiers et de matrices distance/duree en France, sur les donnees OpenStreetMap. Deux endpoints partageant le meme moteur de calcul, hebergement francais (OVH), pas de dependance a Google Maps / Mapbox / HERE. Les deux acceptent adresses brutes (validation BAN automatique) ou coordonnees WGS84, mixables dans une meme requete. - Endpoint matrice : `POST /v1/route/summary` (distance et duree entre origines et destinations) - Endpoint itineraire : `POST /v1/route/compute` (itineraire detaille : polyline, etapes turn-by-turn) - /route/summary disponible : Growth, Business - /route/compute disponible : Business uniquement - Page : https://trustydata.fr/usecases/itineraires-distances-france - Guide : https://trustydata.fr/docs/itineraires.html ### Serveur MCP Acces a toutes les fonctionnalites TrustyData (adresses, communes, entreprises, itineraires, statistiques INSEE d'une zone de chalandise) via le Model Context Protocol. Compatible claude.ai et Claude Desktop, ChatGPT en mode developpeur (beta, offres payantes), et editeurs de code (Cursor, VS Code, Zed). Authentification OAuth 2.1 avec le meme e-mail que l'espace client, aucune cle API a coller. Zero code, configuration en 3 minutes. Un appel via MCP est decompte comme un appel equivalent en API REST (1 unite de quota). - URL MCP : `https://mcp.trustydata.app/mcp` - Disponible : tous les plans (acces inclus sans surcout) - Outils : verify_address, search_address, get_address_details, search_locality, search_company, get_company_details, search_nearby, route_matrix, compute_route, zone_stats (population, menages, niveau de vie moyen, profil, CSP, potentiel de depense et prix immobiliers DVF d'une zone - plan Growth) - Page : https://trustydata.fr/usecases/mcp-qualite-donnees ### Recherche d'entreprises (SIRENE) Recherche parmi 43 millions d'etablissements francais (base SIRENE INSEE) par nom, SIREN/SIRET, code NAF, ville, code postal ou rayon geographique. Fiche complete par etablissement ou entreprise : identite officielle, adresse geolocalisee, dirigeants (RNE/INPI), finances publiees, conventions collectives, procedures collectives (BODACC). Deux drapeaux de confidentialite distincts : `diffusible` (INSEE) signale une unite legale dont le nom et l'adresse sont masques legalement, et `opposition_prospection` (INPI, sur chaque dirigeant, plan Growth) signale une personne opposee a l'usage de ses donnees en prospection commerciale — le premier ne dit rien du demarchage. Mise a jour quotidienne. - Endpoints : `GET /services/v1/company/search?q=` (filtres : adresse, ville, code_postal, code_naf, etat_administratif, siren, lat/lon/rayon_m) et `GET /services/v1/company/view/` - Grain : `grouper=true` (defaut) = 1 resultat par entreprise (SIREN) ; `grouper=false` = 1 resultat par etablissement (SIRET) - Richesse de la fiche (/company/view) par plan : Discovery = identite + adresse ; Starter = + geolocalisation, TVA, compteurs ; Growth = + dirigeants, conventions collectives, recherche par rayon ; Business = + finances, procedures collectives. Les resultats de search sont identiques quel que soit le plan (proximite reservee a Growth et plus). - Page : https://trustydata.fr/usecases/recherche-entreprises-sirene - Guide : https://trustydata.fr/docs/entreprises.html ## Tarifs Tous les prix sont HT. Sans engagement. Facturation mensuelle. | Plan | Prix | Quota | Depassement | Fonctionnalites | |------|------|-------|-------------|-----------------| | Discovery | Gratuit | 20 000 req/mois | Bloque au quota | Verification, autocompletion adresse et communes | | Starter | 19 EUR/mois | 100 000 req/mois | 0,50 EUR / 1 000 req | + Geocodage GPS, geocodage inverse | | Growth | 79 EUR/mois | 500 000 req/mois | 0,25 EUR / 1 000 req | + Codes IRIS | | Business | 149 EUR/mois | 2 000 000 req/mois | Depassement ponctuel tolere sans facturation | + Carroyage INSEE 200m, donnees socio-demographiques | Essai gratuit 15 jours sur les plans payants. L'acces au serveur MCP est inclus dans tous les plans ; un appel via MCP est decompte comme un appel equivalent en API REST (1 unite de quota). Page tarifs : https://trustydata.fr/tarifs Offre Agence (agences web integrant TrustyData chez leurs clients) : marque blanche, une cle API par client final, dashboard de refacturation, licence de revente contractuelle, cles de test gratuites (1 mois, 5 000 req hors pool). Tarifs communiques sur demande — configurateur : https://trustydata.fr/agences ## Sources de donnees - Base Adresse Nationale (BAN) : 26 millions d'adresses francaises - Code Officiel Geographique (COG) INSEE : codes communes, departements, regions - Contours IRIS INSEE : decoupe infra-communale - Carroyage 200m INSEE : indicateurs socio-demographiques - Datanova La Poste : libelles d'acheminement, noms de lieu-dit - IGN : coordonnees geographiques, altimetrie Mise a jour mensuelle. ## FAQ **Quelle precision pour le geocodage ?** Au numero dans la voie quand la BAN dispose de l'information. Sinon, descente automatique au niveau rue, lieu-dit ou commune avec un score de confiance (0 a 1) retourne dans chaque reponse. **Comment integrer TrustyData a mon CRM ou pipeline data ?** API REST classique avec un appel par adresse. Compatible avec script Python, job ETL, workflow n8n/Make, formulaire web. Pour Claude/ChatGPT, le serveur MCP evite d'ecrire du code. **Mes donnees sont-elles stockees ? Conformite RGPD ?** Aucune adresse n'est stockee. Traitement en memoire, oublie a la fin de l'appel. Hebergement OVH France, aucune sortie de l'UE, aucun sous-traitant hors UE. DPA disponible sur demande. **Que se passe-t-il en cas de depassement de quota ?** Starter et Growth : overage transparent au volume depasse, pas de coupure de service. Business : depassement ponctuel tolere sans facturation ; un usage durablement superieur a 2 M req/mois releve d'une offre sur mesure. Plan Discovery (gratuit) : code 429 a 20 000 req/mois, pas d'overage. **Difference avec api-adresse.data.gouv.fr ou Google ?** Vs api-adresse.data.gouv.fr : scoring de confiance, IRIS, carroyage 200m, MCP, SLA contractuel. Vs Google : 5-10x moins cher au volume, donnees francaises, aucune sortie de l'UE. **Comment fonctionne le serveur MCP ?** Standard ouvert qui permet a un LLM (Claude, ChatGPT) d'utiliser des outils externes. URL : `mcp.trustydata.app/mcp`. Connexion OAuth avec le meme e-mail que votre espace client. Vous demandez en langage naturel, le LLM appelle les bons endpoints TrustyData. Un appel via MCP consomme 1 unite de quota, comme un appel en API REST. ## Specifications techniques - Format : API REST, reponses JSON - Temps de reponse : 15-30 ms (API REST), 1-3 s (MCP, inclut le temps de reflexion du LLM) - Coordonnees : WGS84 (lat/lon) et Lambert 93 (EPSG:2154) - Couverture : France metropolitaine + DOM-TOM - Hebergement : OVH SAS, infrastructure francaise - Conformite : RGPD, privacy-by-design, donnees jamais stockees ## Informations legales - Societe : TrustyData EURL - SIRET : 97988532400017 - TVA : FR77979885324 - Siege : Nesles-la-Vallee, Val-d'Oise 95690, France - Dirigeant : Herve Tristram - Contact : https://trustydata.fr/contact ## Demos interactives (sans inscription) Dix demos interactives testent les APIs TrustyData. Quota : 50 appels par heure par visiteur et par endpoint (pool independant par demo). Les clefs API utilisees sont dediees aux demos (plan Business par defaut). - Hub des demos : https://trustydata.fr/demo - Agent IA + MCP (assistant connecte au serveur MCP, langage naturel) : https://trustydata.fr/demo/mcp-agent - Autocompletion d'adresse : https://trustydata.fr/demo/address-autocomplete - Verification d'adresse : https://trustydata.fr/demo/address-verify - Autocompletion de commune : https://trustydata.fr/demo/locality-autocomplete - Recherche avancee de communes : https://trustydata.fr/demo/locality-search - Calcul d'itineraire (routage OpenStreetMap) : https://trustydata.fr/demo/route-compute - Recherche de proximite (adresses dans un rayon autour d'un point, carte + liste, des le plan Growth) : https://trustydata.fr/demo/address-proximity - Recherche de points de vente (Mes lieux — le site le plus proche dans un referentiel de 1 000 sites, carte + horaires) : https://trustydata.fr/demo/locations-search - Zone de chalandise (isochrone reelle depuis un point de vente, sites du reseau dedans) : https://trustydata.fr/demo/zone-de-chalandise - Recherche d'entreprise SIRENE (nom, SIREN, SIRET, NAF, proximite ; fiche etablissement detaillee) : https://trustydata.fr/demo/company-search Les demos adresse (autocomplete et verify) et la demo entreprise incluent un selecteur de plan (Discovery / Starter / Growth / Business) pour montrer la difference de volumetrie des reponses selon l'abonnement. Sur la demo entreprise, la recherche renvoie les memes resultats quel que soit le plan ; seule la richesse de la fiche etablissement change. Changer de plan relance l'appel API. ## Pages du site - Accueil : https://trustydata.fr/ - Tarifs : https://trustydata.fr/tarifs - Demos : https://trustydata.fr/demo - Verification d'adresses : https://trustydata.fr/usecases/verification-adresses - Geocodage : https://trustydata.fr/usecases/coordonnees-gps-wgs84 - Geocodage IRIS : https://trustydata.fr/usecases/geocodage-statistique-iris - Recherche de proximite : https://trustydata.fr/usecases/recherche-proximite - Point de vente le plus proche (Mes lieux) : https://trustydata.fr/usecases/point-de-vente-le-plus-proche - Zone de chalandise : https://trustydata.fr/usecases/zone-de-chalandise - Autocompletion adresse : https://trustydata.fr/usecases/autocompletion-adresse - Autocompletion communes : https://trustydata.fr/usecases/autocompletion-communes - Serveur MCP : https://trustydata.fr/usecases/mcp-qualite-donnees - Recherche d'entreprises : https://trustydata.fr/usecases/recherche-entreprises-sirene - Glossaire : https://trustydata.fr/ressources/glossaire (adresses ET vocabulaire entreprises : SIRENE, siretisation, RNE, BODACC, NAF/APE, diffusibilite) - Creer un compte : https://app.trustydata.app/signup - Contact : https://trustydata.fr/contact - Créer une zone de chalandise, sans code puis avec l'API : https://trustydata.fr/blog/calculer-une-zone-de-chalandise - Smappen et TrustyData : https://trustydata.fr/blog/alternative-smappen-zone-de-chalandise ## Blog - [Comprendre et exploiter la zone de chalandise](https://trustydata.fr/blog/comprendre-et-exploiter-la-zone-de-chalandise) : définition de la zone de chalandise, zones primaire/secondaire/tertiaire, méthode de calcul en isochrone, données publiques françaises (INSEE, BAN, IRIS). - [API Adresse (BAN) : limites et alternative](https://trustydata.fr/blog/api-adresse-ban-limites-alternative) : comparatif honnête API Adresse gouv gratuite vs TrustyData (enrichissement IRIS/Filosofi, verdict, MCP, SLA). - [SIREN et facturation électronique 2026](https://trustydata.fr/blog/siren-facturation-electronique-2026) : au 1er septembre 2026 le SIREN du client devient une mention obligatoire et sert au routage via l'annuaire central (AIFE) ; distinction SIREN/SIRET, rejets de facture, déduplication et enrichissement de la base SIRENE. - [Sirétisation : SIREN, NIC, SIRET et clé de contrôle expliqués](https://trustydata.fr/blog/siretisation-siren-nic-siret) : guide technique de la sirétisation — structure SIREN + NIC, calcul de la clé de Luhn pas à pas, exception La Poste (SIREN 356 000 000), numéro de TVA déduit du SIREN, unité légale vs établissement, événements qui changent un SIRET, pièges (non-diffusibles, zéros de tête) et méthode de rattachement d'un fichier tiers.