Trouver et qualifier une entreprise depuis votre logiciel avec l'API Recherche d'entreprises

Ce que renvoie l'API Recherche d'entreprises

L'API Recherche d'entreprises est produite par la Direction interministérielle du numérique (DINUM), avec l'Insee et l'INPI comme partenaires, et fait partie du projet Annuaire des Entreprises, dont l'équipe répond aux questions des utilisateurs sur data.gouv.fr. Elle répond sur recherche-entreprises.api.gouv.fr. Une recherche se fait en texte libre (nom, SIREN, SIRET, adresse, dirigeant, élu) ou par critère géographique, et peut être filtrée, par exemple par code postal ou par code NAF. Chaque résultat donne au minimum la dénomination, le SIREN, le SIRET et le code NAF ; le dépôt de code public du projet annonce aussi des données sur les établissements, les dirigeants et les bilans.

Le traitement qui construit l'index est planifié chaque jour pour la plupart de ces sources ; la fraîcheur réelle dépend du rythme de publication de chaque producteur.

Accès libre, 7 appels par seconde : les conditions d'usage

• Aucune authentification : la fiche officielle sur data.gouv.fr décrit l'API comme « totalement ouverte d'accès ». Pas de compte, pas de clé.
• 7 appels par seconde : c'est la limite publiée, que l'administration peut abaisser en cas de surcharge. Le logiciel doit donc savoir ralentir.
• Un service public sans contrat avec vous : la fiche affiche un taux de disponibilité, mais l'accès libre ne s'accompagne d'aucun engagement signé. Le 23 avril 2026, un incident en cours sur l'API a été signalé, puis déclaré résolu le jour même.
• Pas de notification : l'API se consulte ; elle ne prévient pas votre logiciel d'un changement.
• Un code ouvert : le code de l'API est publié sous licence MIT sur GitHub, ce qui permet de comprendre précisément son fonctionnement.

Quelles données manquent, et pourquoi ?

La fiche officielle liste trois exclusions : les prédécesseurs et successeurs des établissements, les entreprises non diffusibles et les entreprises dont l'immatriculation au RCS a été refusée. L'équipe de l'Annuaire des Entreprises a précisé en mai 2025 que les entreprises non diffusibles n'apparaissent pas dans les filtres, et que seul l'INPI peut diffuser leurs données.

D'autres précisions publiées par l'équipe évitent des erreurs de conception :

• le filtre sur l'activité principale porte sur l'unité légale, pas sur chaque établissement ;
• un SIREN ou un SIRET placé dans le texte de recherche fait ignorer les autres filtres ;
• l'adresse n'est pas découpée en champs séparés dans l'API ; ce découpage reste disponible dans l'API Sirene ;
• une modification visible sur le site peut n'apparaître dans l'API qu'après la synchronisation quotidienne ;
• les données de dirigeants viennent du RNE, tenu par l'INPI : face à une erreur de dirigeants, l'équipe l'a signalée à l'INPI en décembre 2024.

Six usages dans un logiciel de PME

1. La saisie d'un nouveau client par son nom. Le commercial tape « boulangerie martin lyon » ; le logiciel propose les entreprises correspondantes, et la fiche se remplit avec le SIREN et le SIRET du bon établissement. L'appel part après une courte pause de frappe, pour rester sous les 7 appels par seconde.
2. Le sous-traitant RGE. Une entreprise de rénovation énergétique vérifie que l'artisan sous-traitant figure bien parmi les entreprises RGE avant de l'affecter à un chantier aidé. Voir notre page logiciel de rénovation énergétique.
3. La convention collective du client. Une agence d'emploi récupère la convention collective renseignée de l'entreprise utilisatrice au moment de créer le contrat de mission. Voir notre page logiciel intérim.
4. L'organisme de formation partenaire. Une plateforme qui référence des organismes contrôle leur présence dans la liste publique des organismes de formation avant de les publier.
5. Le signataire d'un contrat professionnel. À l'ouverture d'un compte, le logiciel affiche les dirigeants déclarés au RNE, pour vérifier que la personne qui signe représente bien l'entreprise.
6. Le secteur à prospecter. Une entreprise de maintenance filtre par code postal et code NAF pour préparer une tournée commerciale, puis croise le résultat avec ses clients existants.

API Recherche d'entreprises ou API Sirene : laquelle pour quoi ?

Les deux se combinent bien : la recherche d'entreprises pour trouver l'entreprise pendant la saisie, l'API Sirene pour la fiche de référence et sa surveillance dans la durée. Le détail figure sur notre page intégration de l'API Sirene.

Ce qu'il faut prévoir, et ce que YMHB Web livre

• Un cache : une entreprise déjà consultée dans la journée ne repart pas vers l'API.
• Une file et un ralentisseur : tous les utilisateurs du logiciel partagent les 7 appels par seconde du serveur.
• Un mode dégradé : si l'API ne répond pas, la saisie manuelle reste possible et la fiche se complète plus tard.
• La provenance de chaque donnée : chaque information récupérée garde sa date et sa source (Sirene, RNE, label), pour savoir ce qui a été vérifié et quand.
• Le RGPD : les noms des dirigeants sont des données personnelles ; leur usage, notamment commercial, entre dans votre registre des traitements (voir notre guide RGPD et logiciel métier).

Pour une vérification ponctuelle, la recherche à la main sur le site de l'Annuaire des Entreprises suffit. Quand la recherche doit vivre dans votre CRM ou logiciel métier, YMHB Web développe le module de recherche, le cache et la file d'appels, dépose chez vous le code, qui vous appartient au paiement intégral, avec sa documentation, et suit les évolutions de l'API dans le cadre de la maintenance.