Accueil›Documentation

התחלה מהירה עם API BODACC

נתונים פתוחים וחינם

ה-API של BODACC הוא חינמי ופתוח: הוא מעניק גישה בנתונים פתוחים ובזמן אמת למסד הנתונים המלא של העיתון הרשמי — 11.3 מיליון הודעות, 6.7 מיליון חברות, 1.9 מיליון אנשים (נתונים חיים stats/counts). בעוד שקובץ BODACC ההיסטורי מורד פעם ביום, ה-API חושף את ההודעות מיד עם פרסומן, ללא מפתח לנתונים ציבוריים.

# המונים המדויקים, ללא מפתח
curl "https://bodacc.io/api/bodacc/stats/counts"

קריאה ראשונה

ה-API הציבורי של BODACC נגיש ללא מפתח לנתונים. נקודת הקצה הנפוצה ביותר מחפשת הודעות לפי מילת מפתח:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"

תשובה (קטע):

{
  "total": 48231,
  "results": [
    {
      "id": "A2023001_000123",
      "dateparution": "2026-08-07",
      "typeavis": "A",
      "familleavis": "creation",
      "commercant": "BOULANGERIE DUPONT",
      "ville": "LYON",
      "numerodepartement": "69"
    }
  ],
  "limit": 5,
  "offset": 0
}

מפרט מלא

ה-API מתעד 46 נקודות קצה (אומת על OpenAPI החי). שתי דרכים לחקור אותן:

  • Swagger UI: https://bodacc.io/api/bodacc/docs
  • https://bodacc.io/api/bodacc/openapi.json

נקודות קצה עיקריות

נקודת קצהתיאור
GET /api/bodacc/annoncesחיפוש הודעות (מילת מפתח, משפחה, עיר, מחלקה, SIREN, תאריכים)
GET /api/bodacc/annonces/{id}פרטי הודעה + קשרים (חברה, אנשים)
GET /api/bodacc/entreprisesחיפוש חברות (שם, SIREN, NAF, מצב, מסננים מורחבים)
GET /api/bodacc/entreprises/{siren}כרטיס מלא של SIREN
GET /api/bodacc/personnes/{id}כרטיס אדם (זהות + מינויים)
GET /api/bodacc/annuaire/{role}מדריך מפרקים, נאמנים, מנהלים
GET /api/bodacc/stats/countsמונים גלובליים (הודעות, חברות, אנשים)

אימות

גישה ציבורית אינה דורשת מפתח. עבור הצעות Pro ו-Enterprise, נקודות הקצה המתועדות מקבלות מפתח API:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

המפתח מועבר גם ב-Authorization: Bearer sk_bodacc_.... מפתח לא חוקי או מבוטל מחזיר 401.

שגיאות

ה-API מחזיר שגיאות HTTP סטנדרטיות עם גוף JSON המפרט את הבעיה:

  • 400: פרמטר לא חוקי
  • 401: מפתח API לא חוקי או מבוטל
  • 404: משאב לא נמצא
  • 429: יותר מדי בקשות — כבדו את הכותרת Retry-After

מגבלות

  • limit: בין 1 ל-500 לבקשה
  • offset: עד 10,000 (עימוד נגד הורדות המוניות)
  • הנתונים מתעדכנים בזמן אמת לאחר כל פרסום של BODACC
  • חיפוש לפי משפחה משתמש בסכומים מדויקים ממומשים (total_estime חסר); חיפושי טקסט משולבים עשויים להחזיר סכום משוער ("total_estime": true)

המשך קריאה

FAQ

יש שאלה?

הצוות שלנו יענה לכם במהירות. פנייתכם תועבר עם קטגוריית הAPI.