Intégration API Annuaire des entreprises
Nous développons votre connecteur Annuaire des entreprises
Nous branchons l'API publique de l'Annuaire des entreprises sur votre produit : votre utilisateur tape le nom de sa société, choisit dans une liste, et le SIREN alimente la suite du parcours.
- Équipe produit senior
- connecteurs de données publiques en production
- du cadrage au monitoring
À quoi sert l'API Annuaire des entreprises et comment l'intégrer dans une application ?
L'API Annuaire des entreprises permet de trouver une entreprise française par son nom, son SIRET ou son activité, et d'obtenir en retour ses informations officielles : dénomination, adresse, forme juridique, statut et code NAF. Opérée par la DINUM, elle est gratuite et ouverte sans inscription. On l'intègre dans une application pour automatiser la qualification d'une fiche client à la saisie du nom de l'entreprise, vérifier l'existence légale d'un partenaire ou pré-remplir un formulaire KYC sans demander à l'utilisateur de ressaisir ce qui existe déjà.
Ce que nos clients branchent sur cette API
Champ trouvez votre entreprise
L'utilisateur ne connaît pas son SIREN. Il tape un nom et une commune, choisit dans une liste, et le reste du parcours travaille sur un identifiant.
Vérification légère avant devis
Dénomination et adresse de siège contrôlées à la création d'un devis ou d'un contrat, sans budget d'enrichissement ni contrat fournisseur.
Prospection locale par rayon
La recherche autour d'un point, filtrée par code NAF, construit une tournée commerciale ou une liste d'installateurs à couvrir.
Convention collective préremplie
Le code IDCC applicable alimente un outil de paie, un plan de formation ou un module de conformité sociale, sans saisie de l'utilisateur.
Ce que ça change dans votre parcours
La technique au service d'un résultat mesurable : une inscription qui aboutit, des données justes, zéro coût de licence.
Une inscription qui aboutit
Personne ne connaît son SIREN par cœur. Chercher par nom retire l'obstacle qui fait quitter le formulaire à la deuxième ligne.
Zéro coût de licence
L'API est ouverte et gratuite. Le budget va au développement et au cadrage, pas à un abonnement mensuel à un fournisseur de données.
Un repli gratuit crédible
Si votre fournisseur payant tombe ou si le budget est épuisé, l'identification de base reste disponible et le parcours ne se bloque pas.
Des critères de ciblage intégrés
Secteur, catégorie d'entreprise, territoire et ratios financiers deviennent des filtres dans votre produit, sans export intermédiaire.
Comment nous livrons votre connecteur
Cadrage
Recherche par nom, par identifiant ou par rayon, quels champs affichés, quel volume attendu. On liste les cas limites avant de coder.
Développement
Appels côté serveur, User-Agent identifiant votre application, limiteur prudent bien en dessous du plafond, réponse allégée par défaut.
Recette
Test du piège des filtres ignorés en recherche directe, du plafond de dix mille résultats, et du cas d'une entreprise absente du périmètre.
Monitoring
Alerte sur les 429 et sur la latence, repli documenté vers une source contractualisée. Le débit n'est pas garanti, le produit doit le savoir.
Ce que permet l'API Recherche d'Entreprises
- Recherche plein texte
- Par dénomination, adresse, dirigeant ou élu, ou directement par SIREN et SIRET. C'est la brique du champ tapez le nom de votre entreprise.
- Synthèse multi-bases
- Identité Sirene, dirigeants du registre national, convention collective applicable, labels et ratios financiers, dans une seule réponse.
- Recherche géographique
- Les entreprises autour d'un point, dans un rayon de cinq kilomètres par défaut et de cinquante au maximum, filtrables par code NAF.
- Filtres sectoriels et financiers
- Code NAF, section d'activité, catégorie d'entreprise, nature juridique, territoire, chiffre d'affaires et résultat net, combinables.
Le vocabulaire de cette API
- near_point
- Le point de terminaison géographique : les entreprises autour de coordonnées, rayon de cinq kilomètres par défaut et de cinquante au maximum. Peu de produits proposent cette fonctionnalité, et elle est gratuite.
- minimal et include
- Le mode de réponse allégée, et la liste des blocs à rappeler : complements, dirigeants, finances, siege, tva. À noter, include ne s'utilise qu'avec minimal à true. Sur une API sous tension, la sobriété est ce qui évite d'être restreint.
- activite_principale_naf25
- Le futur code NAF 2025, renvoyé à côté du code en NAF rév. 2. C'est aujourd'hui le moyen le plus simple de le récupérer sans souscription, pour préparer la bascule du 1er janvier 2027.
- statut_diffusion_etablissement
- Vaut O pour un établissement diffusible et P pour une diffusion partielle après demande d'opposition. Il vient de Sirene et doit être lu, pas ignoré parce que les champs semblent simplement vides.
- liste_idcc
- Les identifiants de convention collective rattachés à l'entreprise. C'est ce qui permet de préremplir un outil de paie, un plan de formation ou un contrôle de conformité sociale sans le demander à l'utilisateur.
- User-Agent
- La documentation recommande un User-Agent explicite et descriptif sur chaque requête. Sur une API ouverte et sous tension, c'est ce qui distingue un intégrateur identifiable d'un aspirateur anonyme quand l'exploitant doit trancher.
Les contraintes réelles de cette API
Le débit annoncé n'est pas un débit garanti
Sept appels par seconde et par IP, plus une limite par opérateur réseau qui se rencontre vite sur un cloud public. La documentation précise que la priorité va aux systèmes internes et aux services publics en cas de tension.
Dix mille résultats, et pas un de plus
La pagination est verrouillée : vingt-cinq résultats par page, et toute requête dont la page dépasse dix mille résultats cumulés renvoie une erreur 400. Cette API sert à trouver une entreprise, pas à aspirer un secteur.
Les filtres sont ignorés en recherche directe
Si la requête contient exactement 9 ou 14 chiffres, l'API fait une recherche directe et ignore silencieusement les autres filtres. Un contrôle du type ce SIRET est-il bien dans ce département renvoie donc une réponse fausse, sans erreur.
Le périmètre est volontairement amputé
Ni les entreprises non diffusibles, ni celles dont l'immatriculation a été refusée. Une entreprise absente n'est pas une entreprise inexistante : le message utilisateur doit le dire et un chemin de saisie manuelle doit rester ouvert.
Annuaire des entreprises ou API Sirene ?
Deux API publiques sur les mêmes entreprises, avec deux usages différents. Le plus souvent, on branche les deux.
| Critère | Annuaire des entreprisesOuverte, sans clé | INSEE / SireneCompte requis |
|---|---|---|
| Accès | Aucun compte, aucune clé | Compte INSEE, clé gratuite |
| Recherche par nom | Oui, c'est sa raison d'être | Non, par identifiant |
| Dirigeants | Oui, issus du registre | Non couverts |
| Périmètre | Amputé, non diffusibles exclus | Le répertoire complet |
| Débit | 7 par seconde, non garanti | 30 par minute, plan public |
| Engagement de service | Aucun contrat opposable | 99,5 % par mois |
| Le bon cas | Trouver l'entreprise par son nom | Vérifier et fiabiliser un SIRET |
L'usage courant combine les deux : la recherche par nom ici, la vérification et le rafraîchissement du référentiel sur l'API Sirene.
Ce que nous mesurons sur cette intégration
Les autres API entreprise
Si cette API ne couvre pas votre besoin, ces options se discutent au cadrage.
Annuaire des entreprisesNous développons votre connecteur Annuaire des entreprisesCette page
INSEE / SireneLe répertoire officiel, gratuit : vérifier un SIRET, préremplir une fiche.
PappersDirigeants, bénéficiaires effectifs, comptes annuels et documents, à la carte.
BODACCLes annonces légales : créations, ventes, procédures collectives.On combine Annuaire des entreprises avec
La stack qui entoure cette API sur nos projets.
Annuaire des entreprises : vos questions
C'est l'intégration la plus simple de la catégorie, parce qu'il n'y a ni compte ni clé. On appelle la recherche depuis votre serveur, jamais depuis le navigateur dès qu'il y a du volume, puisque la limite est par adresse IP et par opérateur réseau. On ajoute un User-Agent qui identifie votre application et un contact, comme la documentation le recommande, un limiteur prudent bien en dessous du plafond annoncé, et un cache court sur les recherches et long sur les fiches résolues par SIREN. Le reste du travail est côté produit : quoi afficher dans la liste de résultats, et quoi faire quand l'entreprise n'y est pas.
Oui, totalement : pas de compte, pas de clé, pas de contrat, pas de facture. Ce qui n'existe pas non plus, c'est l'engagement de service. La documentation indique que le débit annoncé est une limite maximale et non un débit garanti, et qu'en période de forte activité la priorité va aux systèmes internes et aux services publics. Un produit commercial est donc, par conception, un usager de seconde priorité. Gratuit ne veut pas dire sans risque : cela veut dire qu'il faut un cache, un débit prudent et un repli.
Ce sont deux API différentes de la DINUM, et la confusion coûte cher en avant-vente. L'API Recherche d'Entreprises est ouverte à tous, sans compte : c'est celle dont parle cette page. L'API Entreprise est réservée aux administrations et exige un haut niveau d'habilitation : c'est elle qui alimente l'espace agent public de l'Annuaire. Un éditeur privé n'y a pas accès, quel que soit son cas d'usage. Si l'on vous a promis l'API Entreprise pour un produit commercial, la promesse ne tient pas.
Non, et c'est verrouillé exprès. Le nombre total de résultats plafonne à dix mille, la pagination est limitée à vingt-cinq résultats par page, et toute requête qui dépasse ce cumul renvoie une erreur 400 explicite. Le compteur affiché n'est donc pas un compte réel au-delà de ce seuil. Cette API sert à trouver une entreprise, pas à reconstituer une base. Si votre besoin est un fichier sectoriel, il faut passer par les jeux de données en téléchargement ou par un fournisseur commercial, et nous le disons avant de chiffrer.
Pour de la recherche interactive à faible débit, oui, avec un cache, un débit prudent et un User-Agent identifiable. Comme source unique d'un processus critique, non : pas de contrat, pas d'engagement de service opposable, et une priorité donnée aux services publics en cas de tension. Nous ne mettons jamais une API sans contrat seule sur le chemin d'un encaissement ou d'une décision. Le schéma que nous recommandons est à deux niveaux, avec une source contractualisée derrière pour l'identification fiable.
Un projet d'intégration Annuaire ?
Parlons-en. 30 minutes pour cadrer votre besoin, vérifier ce que cette API publique permet vraiment et vous dire franchement ce qui est faisable.
Parler de mon projet Annuaire des entreprises