Company API: SIREN record
Ricerca di un'azienda
L'endpoint GET /api/bodacc/entreprises interroga la base di oltre 6 milioni di aziende francesi provenienti dagli annunci legali e dal registro.
# Per nome
curl "https://bodacc.io/api/bodacc/entreprises?q=boulangerie&limit=5"
Un SIREN esatto di 9 cifre viene rilevato automaticamente e trattato con uguaglianza indicizzata (risposta immediata):
curl "https://bodacc.io/api/bodacc/entreprises?q=123456789"
Filtrare la ricerca
| Parametro | Descrizione |
|---|---|
q | Nome o SIREN esatto (9 cifre) |
ville | Città della sede |
naf | Codice NAF (inizio codice) |
departement | Codice dipartimento (prime 2 cifre del CAP) |
code_postal | Inizio del codice postale |
etat | A (attiva) o C (cessata) |
categorie | Dimensione (PME, ETI, GE...) |
tranche | Fascia di numero di dipendenti |
forme | Forma giuridica |
dmin / dmax | Data di creazione min/max |
fmin / fmax | Data di chiusura min/max |
# Aziende attive del 33 con un sito web
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&etat=A&avec_site=true&limit=20"
Criteri arricchiti
L'arricchimento (data.gouv.fr, sito ufficiale, reti) consente di mirare con precisione:
avec_site: dispone di un sito web verificatoavec_email: email pubblica notaavec_tel: telefono pubblico notoavec_reseaux: social network notiavec_dirigeants: dirigenti identificatisite_verifie: sito verificato come ufficiale
Le etichette dell'economia sociale e solidale sono filtrabili: ess, siae, bio, rge, qualiopi.
La scheda completa di un SIREN
GET /api/bodacc/entreprises/{siren} restituisce la scheda dettagliata: identità, indirizzo INSEE, NAF, dirigenti e gli annunci collegati.
curl "https://bodacc.io/api/bodacc/entreprises/123456789"
Gli annunci di un'azienda si paginano tramite GET /api/bodacc/entreprises/{siren}/annonces, e lo slug leggibile si risolve tramite /api/bodacc/entreprises/by-slug/{slug}.
Esempio
Trovare tutte le aziende bio di un dipartimento con dirigenti:
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&bio=true&avec_dirigeants=true&limit=50"
Per approfondire
- Avvio rapido : prima chiamata
- Ricerca di annunci : risalire da un SIREN ai suoi annunci
- Persone e annuario : i dirigenti dietro le aziende