Search BODACC announcements
Ricerca degli annunci
L'endpoint GET /api/bodacc/annonces interroga il Bollettino Ufficiale degli Annunci Civili e Commerciali: creazioni, vendite, modifiche, cancellazioni, procedure collettive e depositi di bilanci, in tempo reale dopo ogni pubblicazione.
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
Parametri di ricerca
| Parametro | Descrizione | Esempio |
|---|---|---|
q | Parola chiave nel commerciante o nella città | q=dupont |
typeavis | Tipo di avviso | typeavis=A (creazione) |
famille | Famiglia di annunci | famille=liquidation |
departement | Codice del dipartimento | departement=33 |
ville | Città (insensibile agli accenti) | ville=LYON |
date_debut | Pubblicazione a partire da (ISO) | date_debut=2026-07-01 |
date_fin | Pubblicazione fino al (ISO) | date_fin=2026-07-31 |
siren | Filtro per SIREN (registro) | siren=123456789 |
limit | Numero di risultati (da 1 a 500) | limit=50 |
offset | Paginazione (da 0 a 10 000) | offset=50 |
Famiglie di annunci
Le famiglie principali: creation, immatriculation, vente, modification, radiation, collective (procedure collettive), conciliation, retablissement, dpc (depositi dei bilanci), divers.
# Liquidazioni del mese nel dipartimento 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"
Paginazione e limiti
limit: tra 1 e 500 per richiesta (predefinito 20)offset: fino a 10 000 — oltre, i risultati vengono troncati volontariamente (anti-dump)- Il campo
totalindica il numero totale di risultati;total_estime: truesegnala un totale stimato dal planner PostgreSQL (ricerche testuali combinate) — i filtri semplici (famiglia, dipartimento) utilizzano totali esatti materializzati
Leggere una risposta
Ogni risultato contiene: id, dateparution, numeroannonce, typeavis, typeavis_lib, familleavis, familleavis_lib, numerodepartement, departement_nom_officiel, commercant, ville, cp, tribunal, slug, registre.
Il dettaglio completo di un annuncio (con le relazioni impresa e persone) si recupera tramite GET /api/bodacc/annonces/{id}:
curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"
Esempio completo
Cercare le cancellazioni di commercianti a Bordeaux negli ultimi 30 giorni:
curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"
Per approfondire
- Avvio rapido: prima chiamata ed errori
- Schede imprese: risalire dall'annuncio alla scheda SIREN
- Autenticazione e limiti: chiavi API e quote