Comment filtrer les annonces par SIREN ?

Passez le paramètre siren=123456789 : l'API interroge le registre de l'annonce via l'index GIN et renvoie toutes les annonces liées à ce SIREN, sans compter sur le nom du commerçant.

Quelle est la limite de résultats par requête ?

limit accepte entre 1 et 500, défaut 20. La pagination s'arrête volontairement à 10 000 résultats cumulés (offset) pour empêcher le dump complet de la base.

Comment filtrer par famille ou par période ?

Utilisez famille=creation, vente, modification, radiation, collective, dpc... et date_debut/date_fin au format ISO (AAAA-MM-JJ).

Que signifie total_estime ?

Les filtres simples (famille, département) utilisent des totaux exacts matérialisés. Les recherches texte combinées renvoient un total estimé par le planificateur PostgreSQL, signalé par total_estime à true.

Rechercher des annonces BODACC : BODACC.io

Rechercher des annonces

L'endpoint GET /api/bodacc/annonces interroge le Bulletin Officiel des Annonces Civiles et Commerciales : créations, ventes, modifications, radiations, procédures collectives et dépôts de comptes, en temps réel après chaque parution.

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

Paramètres de recherche

Paramètre	Description	Exemple
`q`	Mot-clé dans le commerçant ou la ville	`q=dupont`
`typeavis`	Type d'avis	`typeavis=A` (création)
`famille`	Famille d'annonces	`famille=liquidation`
`departement`	Code département	`departement=33`
`ville`	Ville (insensible aux accents)	`ville=LYON`
`date_debut`	Parution à partir du (ISO)	`date_debut=2026-07-01`
`date_fin`	Parution jusqu'au (ISO)	`date_fin=2026-07-31`
`siren`	Filtre par SIREN (registre)	`siren=123456789`
`limit`	Nombre de résultats (1 à 500)	`limit=50`
`offset`	Pagination (0 à 10 000)	`offset=50`

Familles d'annonces

Les familles principales : creation, immatriculation, vente, modification, radiation, collective (procédures collectives), conciliation, retablissement, dpc (dépôts des comptes), divers.

# Liquidations du mois dans le 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"

Pagination et limites

limit : entre 1 et 500 par requête (défaut 20)
offset : jusqu'à 10 000 — au-delà, les résultats sont tronqués volontairement (anti-dump)
Le champ total donne le nombre total de résultats ; total_estime: true signale un total estimé par le planificateur PostgreSQL (recherches texte combinées) — les filtres simples (famille, département) utilisent des totaux exacts matérialisés

Lire une réponse

Chaque résultat contient : id, dateparution, numeroannonce, typeavis, typeavis_lib, familleavis, familleavis_lib, numerodepartement, departement_nom_officiel, commercant, ville, cp, tribunal, slug, registre.

Le détail complet d'une annonce (avec les relations entreprise et personnes) se récupère via GET /api/bodacc/annonces/{id} :

curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"

Exemple complet

Rechercher les radiations de commerçants à Bordeaux sur les 30 derniers jours :

curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"

Aller plus loin

Démarrage rapide : premier appel et erreurs
Fiches entreprises : remonter de l'annonce à la fiche SIREN
Authentification et limites : clés API et quotas

Rechercher des annonces BODACC