Unternehmens API: SIREN Profil
Ein Unternehmen suchen
Der Endpunkt GET /api/bodacc/entreprises durchsucht die Datenbank mit über 6 Millionen französischen Unternehmen aus den gesetzlichen Bekanntmachungen und dem Register.
# Nach Name
curl "https://bodacc.io/api/bodacc/entreprises?q=boulangerie&limit=5"
Eine exakte 9-stellige SIREN-Nummer wird automatisch erkannt und als indizierte Gleichheit behandelt (sofortige Antwort):
curl "https://bodacc.io/api/bodacc/entreprises?q=123456789"
Suche filtern
| Parameter | Beschreibung |
|---|---|
q | Name oder exakte SIREN-Nummer (9 Ziffern) |
ville | Stadt des Sitzes |
naf | NAF-Code (Codeanfang) |
departement | Département-Code (erste 2 Ziffern der PLZ) |
code_postal | Anfang der Postleitzahl |
etat | A (aktiv) oder C (beendet) |
categorie | Größe (KMU, ETI, GE...) |
tranche | Mitarbeiterzahl-Klasse |
forme | Rechtsform |
dmin / dmax | Gründungsdatum min/max |
fmin / fmax | Schließungsdatum min/max |
# Aktive Unternehmen aus dem Département 33 mit Website
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&etat=A&avec_site=true&limit=20"
Erweiterte Kriterien
Die Anreicherung (data.gouv.fr, offizielle Website, soziale Netzwerke) ermöglicht eine präzise Zielgruppenauswahl:
avec_site: verfügt über eine verifizierte Websiteavec_email: öffentliche E-Mail bekanntavec_tel: öffentliche Telefonnummer bekanntavec_reseaux: soziale Netzwerke bekanntavec_dirigeants: Geschäftsführer identifiziertsite_verifie: Website als offiziell verifiziert
Die Labels der Sozial- und Solidarwirtschaft sind filterbar: ess, siae, bio, rge, qualiopi.
Das vollständige Profil einer SIREN : Nummer
GET /api/bodacc/entreprises/{siren} liefert das detaillierte Profil: Identität, INSEE-Adresse, NAF, Geschäftsführer und die zugehörigen Bekanntmachungen.
curl "https://bodacc.io/api/bodacc/entreprises/123456789"
Die Bekanntmachungen eines Unternehmens werden über GET /api/bodacc/entreprises/{siren}/annonces paginiert, und der lesbare Slug wird über /api/bodacc/entreprises/by-slug/{slug} aufgelöst.
Beispiel
Alle Bio-Unternehmen eines Départements mit Geschäftsführern finden:
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&bio=true&avec_dirigeants=true&limit=50"
Weiterführendes
- Schnellstart : erster Aufruf
- Bekanntmachungen suchen : von einer SIREN-Nummer zu ihren Bekanntmachungen
- Personen und Verzeichnis : die Geschäftsführer hinter den Unternehmen