L'API BODACC est-elle gratuite ?

Oui, l'API BODACC est gratuite et ouverte sur les données publiques : annonces, entreprises, personnes, annuaire et statistiques, sans clé ni abonnement. Les offres Pro et Enterprise ajoutent des clés API et des accès prioritaires.

Faut-il une clé API ?

Non, l'accès public ne demande aucune clé. Les clés API (préfixe sk_bodacc_) sont fournies avec les offres Pro et Enterprise pour les endpoints qui l'exigent, depuis Mon compte puis API.

Quelles sont les limites de l'API ?

limit est borné à 500 résultats par requête et offset à 10 000. L'annuaire est limité à 200 pages de 100. En cas de 429, respectez l'en-tête Retry-After.

Les données sont-elles en temps réel ?

Oui, les annonces sont exposées dès leur parution au BODACC, là où le fichier historique se télécharge une fois par jour.

Démarrage rapide API BODACC : BODACC.io

Open data et gratuité

L'API BODACC est gratuite et ouverte : elle donne accès en open data et en temps réel à la base de données complète du Bulletin Officiel — 11,3 millions d'annonces, 6,7 millions d'entreprises, 1,9 million de personnes (chiffres live stats/counts). Là où le fichier BODACC historique se télécharge une fois par jour, l'API expose les annonces dès leur parution, sans clé pour les données publiques.

# Les compteurs exacts, sans clé
curl "https://bodacc.io/api/bodacc/stats/counts"

Premier appel

L'API publique BODACC est accessible sans clé pour les données. Le endpoint le plus utilisé recherche des annonces par mot-clé :

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

Réponse (extrait) :

{
  "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
}

Spécification complète

L'API documente 46 endpoints (vérifié sur l'OpenAPI live). Deux moyens de les explorer :

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

Endpoints principaux

Endpoint	Description
`GET /api/bodacc/annonces`	Recherche d'annonces (mot-clé, famille, ville, département, SIREN, dates)
`GET /api/bodacc/annonces/{id}`	Détail d'une annonce + relations (entreprise, personnes)
`GET /api/bodacc/entreprises`	Recherche d'entreprises (nom, SIREN, NAF, état, filtres enrichis)
`GET /api/bodacc/entreprises/{siren}`	Fiche complète d'un SIREN
`GET /api/bodacc/personnes/{id}`	Fiche personne (identité + mandats)
`GET /api/bodacc/annuaire/{role}`	Annuaire des liquidateurs, mandataires, administrateurs
`GET /api/bodacc/stats/counts`	Compteurs globaux (annonces, entreprises, personnes)

Authentification

L'accès public ne demande aucune clé. Pour les offres Pro et Enterprise, les endpoints documentés acceptent une clé API :

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

La clé se passe aussi en Authorization: Bearer sk_bodacc_.... Une clé invalide ou révoquée renvoie 401.

Erreurs

L'API renvoie des erreurs HTTP standards avec un corps JSON détaillant le problème :

400 : paramètre invalide
401 : clé API invalide ou révoquée
404 : ressource introuvable
429 : trop de requêtes — respectez l'en-tête Retry-After

Limites

limit : entre 1 et 500 par requête
offset : jusqu'à 10 000 (pagination anti-dump)
Les données sont mises à jour en temps réel après chaque parution du BODACC
La recherche par famille utilise des totaux exacts matérialisés (total_estime absent) ; les recherches texte combinées peuvent renvoyer un total estimé ("total_estime": true)

Aller plus loin

Rechercher des annonces : tous les paramètres de recherche
Fiches entreprises : recherche et fiche SIREN
Personnes et annuaire : dirigeants et professionnels
Statistiques : compteurs et séries
Authentification et limites : clés API et bonnes pratiques

Démarrage rapide API BODACC