Ist die BODACC-API kostenlos?

Ja, die BODACC-API ist kostenlos und offen für die öffentlichen Daten: Bekanntmachungen, Unternehmen, Personen, Verzeichnis und Statistiken, ohne Schlüssel und ohne Abonnement. Die Pro- und Enterprise-Angebote ergänzen API-Schlüssel und priorisierte Zugänge.

Brauche ich einen API-Schlüssel?

Nein, der öffentliche Zugang benötigt keinen Schlüssel. API-Schlüssel (Präfix sk_bodacc_) werden mit den Pro- und Enterprise-Angeboten für die Endpoints geliefert, die ihn erfordern, über Mein Konto und dann API.

Welche Grenzen hat die API?

limit ist auf 500 Ergebnisse pro Anfrage begrenzt und offset auf 10 000. Das Verzeichnis ist auf 200 Seiten zu 100 begrenzt. Bei 429 beachten Sie den Retry-After-Header.

Sind die Daten in Echtzeit verfügbar?

Ja, die Bekanntmachungen werden ab ihrer Veröffentlichung im BODACC angezeigt, während die historische Datei nur einmal täglich heruntergeladen wird.

Schnellstart BODACC API : BODACC.io

Open Data und Kostenlosigkeit

Die BODACC-API ist kostenlos und offen: Sie bietet Zugang in Echtzeit zur vollständigen Datenbank des Amtsblatts — 11,3 Millionen Bekanntmachungen, 6,7 Millionen Unternehmen, 1,9 Millionen Personen (Live-Zahlen stats/counts). Während die historische BODACC-Datei einmal täglich heruntergeladen wird, stellt die API die Bekanntmachungen ab ihrer Veröffentlichung bereit, ohne Schlüssel für öffentliche Daten.

# Die genauen Zähler, ohne Schlüssel
curl "https://bodacc.io/api/bodacc/stats/counts"

Erster Aufruf

Die öffentliche BODACC-API ist ohne Schlüssel für die Daten zugänglich. Der am häufigsten genutzte Endpunkt sucht Bekanntmachungen nach Stichwort:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"

Antwort (Auszug):

{
  "total": 48231,
  "results": [
    {
      "id": "A2023001_000123",
      "dateparution": "2026-08-07",
      "typeavis": "A",
      "familleavis": "creation",
      "commercant": "BOULANGERIE DUPONT",
      "ville": "LYON",
      "numerodepartement": "69"
    }
  ],
  "limit": 5,
  "offset": 0
}

Vollständige Spezifikation

Die API dokumentiert 46 Endpunkte (verifiziert anhand der Live-OpenAPI). Zwei Möglichkeiten zur Erkundung:

Swagger UI: https://bodacc.io/api/bodacc/docs
https://bodacc.io/api/bodacc/openapi.json

Hauptendpunkte

Endpunkt	Beschreibung
`GET /api/bodacc/annonces`	Suche nach Bekanntmachungen (Stichwort, Familie, Stadt, Departement, SIREN, Daten)
`GET /api/bodacc/annonces/{id}`	Detail einer Bekanntmachung + Verknüpfungen (Unternehmen, Personen)
`GET /api/bodacc/entreprises`	Suche nach Unternehmen (Name, SIREN, NAF, Status, erweiterte Filter)
`GET /api/bodacc/entreprises/{siren}`	Vollständige Karte eines SIREN
`GET /api/bodacc/personnes/{id}`	Personenkarte (Identität + Mandate)
`GET /api/bodacc/annuaire/{role}`	Verzeichnis der Liquidatoren, Mandatsträger, Verwalter
`GET /api/bodacc/stats/counts`	Globale Zähler (Bekanntmachungen, Unternehmen, Personen)

Authentifizierung

Der öffentliche Zugang erfordert keinen Schlüssel. Für die Angebote Pro und Enterprise akzeptieren die dokumentierten Endpunkte einen API-Schlüssel:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

Der Schlüssel kann auch als Authorization: Bearer sk_bodacc_... übergeben werden. Ein ungültiger oder widerrufener Schlüssel führt zu 401.

Fehler

Die API gibt standardmäßige HTTP-Fehler mit einem JSON-Body zurück, der das Problem beschreibt:

400: ungültiger Parameter
401: ungültiger oder widerrufener API-Schlüssel
404: Ressource nicht gefunden
429: zu viele Anfragen — beachten Sie den Header Retry-After

Grenzen

limit: zwischen 1 und 500 pro Anfrage
offset: bis zu 10 000 (Anti-Dump-Paginierung)
Die Daten werden in Echtzeit nach jeder Veröffentlichung des BODACC aktualisiert
Die Suche nach Familie verwendet exakte materialisierte Summen (total_estime fehlt); kombinierte Textsuche kann eine geschätzte Summe zurückgeben ("total_estime": true)

Weiterführendes

Bekanntmachungen suchen: alle Suchparameter
Unternehmenskarten: Suche und SIREN-Karte
Personen und Verzeichnis: Führungskräfte und Fachleute
Statistiken: Zähler und Reihen
Authentifizierung und Grenzen: API-Schlüssel und bewährte Verfahren

Schnellstart BODACC API