Bedrijven API: SIREN bedrijfsfiche
Een bedrijf zoeken
De endpoint GET /api/bodacc/entreprises doorzoekt de database met meer dan 6 miljoen Franse bedrijven uit wettelijke bekendmakingen en het register.
# Op naam
curl "https://bodacc.io/api/bodacc/entreprises?q=boulangerie&limit=5"
Een exact SIREN-nummer van 9 cijfers wordt automatisch herkend en behandeld met geïndexeerde gelijkheid (directe reactie):
curl "https://bodacc.io/api/bodacc/entreprises?q=123456789"
Zoekopdracht filteren
| Parameter | Beschrijving |
|---|---|
q | Naam of exact SIREN-nummer (9 cijfers) |
ville | Stad van de zetel |
naf | NAF-code (begin van de code) |
departement | Departementscode (eerste 2 cijfers van de postcode) |
code_postal | Begin van de postcode |
etat | A (actief) of C (beëindigd) |
categorie | Omvang (KMO, midcap, grootbedrijf...) |
tranche | Klasse van het aantal werknemers |
forme | Rechtsvorm |
dmin / dmax | Oprichtingsdatum min/max |
fmin / fmax | Sluitingsdatum min/max |
# Actieve bedrijven in departement 33 met een website
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&etat=A&avec_site=true&limit=20"
Verrijkte criteria
De verrijking (data.gouv.fr, officiële website, sociale netwerken) maakt een gerichte selectie mogelijk:
avec_site: beschikt over een geverifieerde websiteavec_email: bekend openbaar e-mailadresavec_tel: bekend openbaar telefoonnummeravec_reseaux: bekende sociale netwerkenavec_dirigeants: geïdentificeerde bestuurderssite_verifie: website geverifieerd als officieel
De labels van de sociale en solidaire economie zijn filterbaar: ess, siae, bio, rge, qualiopi.
De volledige fiche van een SIREN
GET /api/bodacc/entreprises/{siren} retourneert de gedetailleerde fiche: identiteit, INSEE-adres, NAF, bestuurders en de gerelateerde bekendmakingen.
curl "https://bodacc.io/api/bodacc/entreprises/123456789"
De bekendmakingen van een bedrijf worden gepagineerd via GET /api/bodacc/entreprises/{siren}/annonces, en de leesbare slug wordt opgelost via /api/bodacc/entreprises/by-slug/{slug}.
Voorbeeld
Alle bio-bedrijven in een departement vinden met bestuurders:
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&bio=true&avec_dirigeants=true&limit=50"
Verder verkennen
- Snel starten : eerste aanroep
- Bekendmakingen zoeken : van een SIREN naar de bijbehorende bekendmakingen
- Personen en bedrijvengids : de bestuurders achter de bedrijven