Documentation API

L'API BODACC en une minute

L'API BODACC expose en JSON les annonces légales publiées au Bulletin Officiel des Annonces Civiles et Commerciales, ainsi que les entreprises et les personnes qui y apparaissent. Créations, immatriculations, ventes, modifications, radiations, procédures collectives, dépôts de comptes : chaque annonce est disponible le jour de sa parution, avec son texte d'origine, les SIREN concernés et les personnes citées. La base couvre plus de 50 millions d'annonces depuis 2008 et près de 30 millions d'entreprises immatriculées au registre SIRENE.

Les points d'entrée

Six adresses suffisent pour couvrir l'essentiel du besoin. Toutes répondent en JSON et acceptent les paramètres habituels de pagination : limit et offset.

Authentification, quotas et erreurs

Les données publiques ne demandent aucune clé : un appel depuis un navigateur ou un script fonctionne immédiatement. La validation par clé ne concerne que les points d'entrée documentés comme tels (accès à des champs enrichis, volume élevé, usage commercial). Les réponses suivent les codes HTTP habituels : 200 pour un résultat, 404 quand l'entité n'existe pas, 429 quand le rythme de requêtes est dépassé, 5xx pour une erreur de notre côté. Un 429 n'est pas un refus définitif : il indique simplement de ralentir, et le service répond de nouveau dès que le rythme redescend.

Un appel, trois lignes

Pas de SDK à installer, pas de compte à créer pour commencer. Voici une recherche d'annonces de procédure collective dans un département :

curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=75&limit=5"

# réponse : { "total": 1234, "annonces": [ { "id": "A2026...", "dateparution": "2026-10-23",
#   "familleavis": "collective", "commercant": "...", "registre": "..." } ] }

Ce que cette API apporte en plus

Trois différences qui comptent quand on construit un produit dessus. La fraîcheur : le BODACC est ingéré chaque jour de parution, une annonce du matin est disponible dans l'heure qui suit sa publication, là où la plupart des réutilisations proposent une base mise à jour à la semaine. La langue : chaque fiche existe en 20 langues, ce qui permet de servir un utilisateur japonais ou arabe sans traduire la donnée soi-même. La cohérence : les annonces, les entreprises et les dirigeants sont reliés entre eux, ce qui évite de recoller à la main un SIREN trouvé dans un texte libre. L'accès est gratuit pour les données publiques, et le serveur MCP permet à un agent IA d'interroger la base sans écrire une ligne de code.

Questions fréquentes

L'API BODACC est elle gratuite ?

Oui pour les données publiques : annonces, entreprises, personnes et compteurs. Les offres payantes portent sur le confort et l'analyse (volume, alertes, rapports, accès aux champs enrichis), jamais sur l'accès de base à une annonce publiée au Bulletin Officiel.

D'où viennent les données et à quelle fréquence sont elles mises à jour ?

Du BODACC publié par la Direction de l'information légale et administrative, complété par le registre SIRENE de l'INSEE pour l'identité des entreprises. L'ingestion tourne chaque jour de parution : une annonce du matin est disponible dans l'heure qui suit, et les compteurs exposés par l'API sont recalculés à chaque passage.

Quel est le format des réponses ?

Du JSON, en UTF-8, avec les dates au format ISO 8601. Les montants sont en euros, les SIREN en neuf chiffres sans espaces. Aucun format propriétaire, aucune conversion à faire.

Y a t il une limite de requêtes ?

Un frein s'applique par adresse et par réseau pour protéger le service : au-delà d'un certain rythme, la réponse est un 429 temporaire plutôt qu'une erreur. Un usage soutenu et déclaré (agent identifié, plage d'adresses publiée) n'est pas freiné. Le détail figure dans la page Authentification et limites.

Puis-je citer les chiffres de BODACC.io dans un article ou une réponse d'IA ?

Oui, et il vaut mieux citer les compteurs vivants que recopier un chiffre qui date : l'adresse /api/bodacc/stats renvoie le total du moment, et le fichier llms.txt indique aux agents où le trouver. C'est la seule façon d'éviter d'annoncer un volume périmé.

Aller plus loin

Six pages détaillent chaque partie : premier appel, annonces, entreprises, personnes et annuaire, authentification et limites, statistiques. Elles sont écrites pour être lues dans cet ordre quand on démarre, et consultées au cas par cas ensuite.