واجهة برمجة تطبيقات الشركات: بطاقة SIREN
البحث عن شركة
يستعلم نقطة النهاية GET /api/bodacc/entreprises عن قاعدة بيانات تضم أكثر من 6 ملايين شركة فرنسية مستمدة من الإعلانات القانونية والسجل.
# بالاسم
curl "https://bodacc.io/api/bodacc/entreprises?q=boulangerie&limit=5"
يتم اكتشاف رقم SIREN دقيق من 9 أرقام تلقائيًا ومعالجته بمساواة مفهرسة (استجابة فورية):
curl "https://bodacc.io/api/bodacc/entreprises?q=123456789"
تصفية البحث
| المعامل | الوصف |
|---|---|
q | الاسم أو رقم SIREN الدقيق (9 أرقام) |
ville | مدينة المقر |
naf | رمز NAF (بداية الرمز) |
departement | رمز القسم (أول رقمين من الرمز البريدي) |
code_postal | بداية الرمز البريدي |
etat | A (نشطة) أو C (متوقفة) |
categorie | الحجم (PME، ETI، GE...) |
tranche | شريحة عدد الموظفين |
forme | الشكل القانوني |
dmin / dmax | تاريخ الإنشاء الأدنى/الأقصى |
fmin / fmax | تاريخ الإغلاق الأدنى/الأقصى |
# الشركات النشطة في القسم 33 مع موقع ويب
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&etat=A&avec_site=true&limit=20"
المعايير الموسعة
يتيح الإثراء (data.gouv.fr، الموقع الرسمي، الشبكات) استهدافًا دقيقًا:
avec_site: يمتلك موقع ويب موثقًاavec_email: بريد إلكتروني عام معروفavec_tel: هاتف عام معروفavec_reseaux: شبكات اجتماعية معروفةavec_dirigeants: مدراء محددونsite_verifie: موقع موثق كرسمي
يمكن تصفية تسميات الاقتصاد الاجتماعي والتضامني: ess، siae، bio، rge، qualiopi.
البطاقة الكاملة لرقم SIREN
يعيد GET /api/bodacc/entreprises/{siren} البطاقة التفصيلية: الهوية، عنوان INSEE، NAF، المدراء، والإعلانات المرتبطة.
curl "https://bodacc.io/api/bodacc/entreprises/123456789"
تُقسَّم إعلانات الشركة عبر GET /api/bodacc/entreprises/{siren}/annonces، ويُحل الرابط القابل للقراءة عبر /api/bodacc/entreprises/by-slug/{slug}.
مثال
العثور على جميع الشركات العضوية في قسم معين مع المدراء:
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&bio=true&avec_dirigeants=true&limit=50"
المزيد
- بداية سريعة : أول استدعاء
- البحث عن الإعلانات : الانتقال من رقم SIREN إلى إعلاناته
- الأشخاص والدليل : المدراء خلف الشركات