جستجوی آگهیهای BODACC
جستجوی آگهیها
endpoint GET /api/bodacc/annonces بولتن رسمی آگهیهای مدنی و تجاری را جستجو میکند: ایجادها، فروشها، تغییرات، حذفها، رویههای جمعی و سپردههای حسابها، بهصورت بلادرنگ پس از هر انتشار.
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
پارامترهای جستجو
| پارامتر | توضیحات | مثال |
|---|---|---|
q | کلمه کلیدی در تاجر یا شهر | q=dupont |
typeavis | نوع آگهی | typeavis=A (ایجاد) |
famille | خانواده آگهیها | famille=liquidation |
departement | کد دپارتمان | departement=33 |
ville | شهر (بدون حساسیت به لهجه) | ville=LYON |
date_debut | انتشار از تاریخ (ISO) | date_debut=2026-07-01 |
date_fin | انتشار تا تاریخ (ISO) | date_fin=2026-07-31 |
siren | فیلتر بر اساس SIREN (ثبت) | siren=123456789 |
limit | تعداد نتایج (۱ تا ۵۰۰) | limit=50 |
offset | صفحهبندی (۰ تا ۱۰٬۰۰۰) | offset=50 |
خانوادههای آگهیها
خانوادههای اصلی: creation، immatriculation، vente، modification، radiation، collective (رویههای جمعی)، conciliation، retablissement، dpc (سپردههای حسابها)، divers.
# انحلالهای ماه جاری در دپارتمان ۳۳
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"
صفحهبندی و محدودیتها
limit: بین ۱ تا ۵۰۰ در هر درخواست (پیشفرض ۲۰)offset: تا ۱۰٬۰۰۰ — فراتر از آن، نتایج عمداً کوتاه میشوند (ضد تخلیه داده)- فیلد
totalتعداد کل نتایج را نشان میدهد؛total_estime: trueنشاندهنده مجموع تخمینی توسط برنامهریز PostgreSQL است (جستجوهای متنی ترکیبی) — فیلترهای ساده (خانواده، دپارتمان) از مجموعهای دقیق مادیشده استفاده میکنند
خواندن یک پاسخ
هر نتیجه شامل: id، dateparution، numeroannonce، typeavis، typeavis_lib، familleavis، familleavis_lib، numerodepartement، departement_nom_officiel، commercant، ville، cp، tribunal، slug، registre.
جزئیات کامل یک آگهی (با روابط شرکت و اشخاص) از طریق GET /api/bodacc/annonces/{id} بازیابی میشود:
curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"
مثال کامل
جستجوی حذف تاجران در بوردو در ۳۰ روز گذشته:
curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"
گامهای بعدی
- شروع سریع: اولین فراخوانی و خطاها
- پروندههای شرکتها: صعود از آگهی به پرونده SIREN
- احراز هویت و محدودیتها: کلیدهای API و سهمیهها