API شرکتها: شناسه SIREN
جستجوی یک شرکت
انپوینت GET /api/bodacc/entreprises پایگاه داده بیش از ۶ میلیون شرکت فرانسوی حاصل از آگهیهای قانونی و ثبت را جستجو میکند.
# بر اساس نام
curl "https://bodacc.io/api/bodacc/entreprises?q=boulangerie&limit=5"
یک SIREN دقیق ۹ رقمی بهطور خودکار شناسایی شده و بهصورت برابری ایندکسشده پردازش میشود (پاسخ فوری):
curl "https://bodacc.io/api/bodacc/entreprises?q=123456789"
فیلتر کردن جستجو
| پارامتر | توضیحات |
|---|---|
q | نام یا SIREN دقیق (۹ رقم) |
ville | شهر دفتر مرکزی |
naf | کد NAF (ابتدای کد) |
departement | کد دپارتمان (۲ رقم اول کد پستی) |
code_postal | ابتدای کد پستی |
etat | A (فعال) یا C (متوقفشده) |
categorie | اندازه (PME، ETI، GE و...) |
tranche | بازه تعداد کارکنان |
forme | شکل حقوقی |
dmin / dmax | تاریخ ایجاد حداقل/حداکثر |
fmin / fmax | تاریخ بستهشدن حداقل/حداکثر |
# شرکتهای فعال دپارتمان ۳۳ با وبسایت
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 به آگهیهای آن
- اشخاص و فهرست : مدیران پشت شرکتها