كيفية تصفية الإعلانات حسب SIREN؟

مرر المعامل siren=123456789: تستعلم API عن سجل الإعلان عبر فهرس GIN وتعيد جميع الإعلانات المرتبطة بهذا SIREN، دون الاعتماد على اسم التاجر.

ما هو حد النتائج لكل طلب؟

يقبل limit بين 1 و500، الافتراضي 20. يتوقف الترقيم عمدًا عند 10 000 نتيجة متراكمة (offset) لمنع التفريغ الكامل لقاعدة البيانات.

كيفية التصفية حسب العائلة أو الفترة؟

استخدم famille=creation, vente, modification, radiation, collective, dpc... وdate_debut/date_fin بصيغة ISO (AAAA-MM-JJ).

ماذا يعني total_estime؟

تستخدم الفلاتر البسيطة (العائلة، القسم) إجماليات دقيقة مادية. تُرجع عمليات البحث النصية المجمعة إجماليًا مقدرًا بواسطة مخطط PostgreSQL، يُشار إليه بـ total_estime بقيمة true.

البحث في إعلانات BODACC : BODACC.io

البحث عن الإعلانات

تستعلم نقطة النهاية 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`	عدد النتائج (1 إلى 500)	`limit=50`
`offset`	ترقيم الصفحات (0 إلى 10,000)	`offset=50`

عائلات الإعلانات

العائلات الرئيسية: creation، immatriculation، vente، modification، radiation، collective (الإجراءات الجماعية)، conciliation، retablissement، dpc (إيداع الحسابات)، divers.

# تصفيات الشهر في الإدارة 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"

ترقيم الصفحات والحدود

limit: بين 1 و500 لكل طلب (الافتراضي 20)
offset: حتى 10,000 — بعد ذلك، يتم اقتطاع النتائج عمدًا (مكافحة التفريغ)
حقل 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"

مثال كامل

البحث عن شطب التجار في بوردو خلال آخر 30 يومًا:

curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"

البحث في إعلانات BODACC