API : Dokumentation

Die BODACC-API in einer Minute

Die BODACC-API stellt die im Bulletin Officiel des Annonces Civiles et Commerciales veröffentlichten Bekanntmachungen sowie die darin erscheinenden Unternehmen und Personen im JSON-Format bereit. Gründungen, Eintragungen, Verkäufe, Änderungen, Löschungen, Insolvenzverfahren, Bilanzhinterlegungen: Jede Bekanntmachung ist am Tag ihres Erscheinens verfügbar, mit ihrem Originaltext, den betroffenen SIREN und den genannten Personen. Die Datenbank umfasst mehr als 50 Millionen Bekanntmachungen seit 2008 und nahezu 30 Millionen im SIRENE-Register eingetragene Unternehmen.

Die Endpunkte

Sechs Adressen genügen, um den wesentlichen Bedarf abzudecken. Alle antworten in JSON und akzeptieren die üblichen Paginierungsparameter: limit und offset.

Authentifizierung, Kontingente und Fehler

Die öffentlichen Daten erfordern keinen Schlüssel: Ein Aufruf aus einem Browser oder einem Skript funktioniert sofort. Die Validierung per Schlüssel betrifft nur die als solche dokumentierten Endpunkte (Zugriff auf angereicherte Felder, hohes Volumen, kommerzielle Nutzung). Die Antworten folgen den üblichen HTTP-Codes: 200 für ein Ergebnis, 404 wenn die Entität nicht existiert, 429 wenn die Anfragerate überschritten wird, 5xx für einen Fehler auf unserer Seite. Ein 429 ist keine endgültige Ablehnung: Er zeigt lediglich an, dass das Tempo gedrosselt werden sollte, und der Dienst antwortet wieder, sobald die Rate sinkt.

Ein Aufruf, drei Zeilen

Kein SDK zu installieren, kein Konto zu erstellen, um zu beginnen. Hier eine Suche nach Bekanntmachungen von Insolvenzverfahren in einem Departement:

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": "..." } ] }

Was diese API zusätzlich bietet

Drei Unterschiede, die zählen, wenn man ein Produkt darauf aufbaut. Die Aktualität: Das BODACC wird an jedem Erscheinungstag eingespielt, eine morgendliche Bekanntmachung ist innerhalb der folgenden Stunde verfügbar, während die meisten Wiederverwendungen eine wöchentlich aktualisierte Datenbank anbieten. Die Sprache: Jedes Profil existiert in 20 Sprachen, was es ermöglicht, einen japanischen oder arabischen Nutzer zu bedienen, ohne die Daten selbst zu übersetzen. Die Kohärenz: Bekanntmachungen, Unternehmen und Geschäftsführer sind miteinander verknüpft, was vermeidet, eine in einem Freitext gefundene SIREN manuell zusammenzufügen. Der Zugang zu den öffentlichen Daten ist kostenlos, und der MCP-Server ermöglicht einem KI-Agenten, die Datenbank abzufragen, ohne eine Zeile Code zu schreiben.

Häufige Fragen

Ist die BODACC-API kostenlos?

Ja für die öffentlichen Daten: Bekanntmachungen, Unternehmen, Personen und Zähler. Die kostenpflichtigen Angebote betreffen den Komfort und die Analyse (Volumen, Benachrichtigungen, Berichte, Zugriff auf angereicherte Felder), niemals den Basis-Zugang zu einer im Bulletin Officiel veröffentlichten Bekanntmachung.

Woher stammen die Daten und wie oft werden sie aktualisiert?

Aus dem von der Direction de l'information légale et administrative veröffentlichten BODACC, ergänzt durch das SIRENE-Register des INSEE für die Identität der Unternehmen. Die Einspielung läuft an jedem Erscheinungstag: Eine morgendliche Bekanntmachung ist innerhalb der folgenden Stunde verfügbar, und die von der API bereitgestellten Zähler werden bei jedem Durchlauf neu berechnet.

Welches Format haben die Antworten?

JSON, in UTF-8, mit Datumsangaben im ISO 8601-Format. Die Beträge sind in Euro, die SIREN neunstellig ohne Leerzeichen. Kein proprietäres Format, keine Konvertierung erforderlich.

Gibt es eine Begrenzung der Anfragen?

Eine Drosselung gilt pro Adresse und pro Netzwerk zum Schutz des Dienstes: Über eine bestimmte Rate hinaus ist die Antwort ein temporärer 429 statt eines Fehlers. Eine nachhaltige und deklarierte Nutzung (identifizierter Agent, veröffentlichte Adressspanne) wird nicht gedrosselt. Einzelheiten finden sich auf der Seite Authentifizierung und Limits.

Kann ich die Zahlen von BODACC.io in einem Artikel oder einer KI-Antwort zitieren?

Ja, und es ist besser, die Live-Zähler zu zitieren, als eine veraltete Zahl zu kopieren: Die Adresse /api/bodacc/stats gibt die aktuelle Gesamtzahl zurück, und die Datei llms.txt zeigt den Agenten, wo sie zu finden ist. Das ist die einzige Möglichkeit, die Nennung eines veralteten Volumens zu vermeiden.

Weiterführende Informationen

Sechs Seiten erläutern jeden Teil im Detail: erster Aufruf, Bekanntmachungen, Unternehmen, Personen und Verzeichnis, Authentifizierung und Limits, Statistiken. Sie sind so geschrieben, dass sie beim Einstieg in dieser Reihenfolge gelesen und später fallweise konsultiert werden.