האם ה-API של BODACC הוא בחינם?

כן לנתונים הציבוריים: מודעות, חברות, אנשים ומונים. ההצעות בתשלום נוגעות לנוחות ולניתוח (נפח, התראות, דוחות, גישה לשדות מועשרים), ולעולם לא לגישה הבסיסית למודעה שפורסמה בעיתון הרשמי.

מאין מגיעים הנתונים ובאיזו תדירות הם מתעדכנים?

מה-BODACC המתפרסם על ידי מנהלת המידע המשפטי והמנהלי, בתוספת מרשם SIRENE של INSEE לזהות החברות. הטעינה פועלת בכל יום פרסום: מודעת בוקר זמינה בתוך השעה שלאחר מכן, והמונים המוצגים על ידי ה-API מחושבים מחדש בכל מעבר.

מהו פורמט התגובות?

JSON, ב-UTF-8, עם תאריכים בפורמט ISO 8601. הסכומים ביורו, מספרי ה-SIREN בתשע ספרות ללא רווחים. אין פורמט קנייני, אין המרה לעשות.

האם יש מגבלת בקשות?

מוחל בלם לפי כתובת ולפי רשת כדי להגן על השירות: מעבר לקצב מסוים, התגובה היא 429 זמני ולא שגיאה. שימוש מוגבר ומוצהר (סוכן מזוהה, טווח כתובות מפורסם) אינו נבלם. הפרטים מופיעים בעמוד אימות ומגבלות.

האם אני יכול לצטט את הנתונים של BODACC.io במאמר או בתשובת בינה מלאכותית?

כן, ומוטב לצטט את המונים החיים מאשר להעתיק מספר מיושן: הכתובת /api/bodacc/stats מחזירה את הסכום הרגעי, וקובץ llms.txt מציין לסוכנים היכן למצוא אותו. זו הדרך היחידה להימנע מהכרזת נפח מיושן.

תיעוד API

תיעוד טכני של API BODACC: endpoints, פרמטרים, דוגמאות ושרת MCP.

ה-API של BODACC בדקה

ה-API של BODACC מציג בפורמט JSON את המודעות המשפטיות המתפרסמות בעיתון הרשמי של המודעות האזרחיות והמסחריות, וכן את החברות והאנשים המופיעים בהן. הקמות, רישומים, מכירות, שינויים, מחיקות, הליכי חדלות פירעון, הפקדת דוחות: כל מודעה זמינה ביום פרסומה, עם הטקסט המקורי שלה, מספרי ה-SIREN הרלוונטיים והאנשים הנזכרים. מסד הנתונים מכסה למעלה מ-50 מיליון מודעות מאז 2008 וכמעט 30 מיליון חברות הרשומות במרשם SIRENE.

נקודות הגישה

שש כתובות מספיקות כדי לכסות את עיקר הצורך. כולן מחזירות JSON ומקבלות את פרמטרי העימוד הרגילים: limit ו-offset.

כתובת	מה היא מחזירה
/api/bodacc/annonces	חיפוש מודעות: q, siren, famille, departement, date_debut, date_fin
/api/bodacc/entreprises/{siren}	כרטיס חברה לפי SIREN: זהות, כתובת, מנהלים, מודעות קשורות
/api/bodacc/personnes/{id}	אדם הנזכר במודעות: תפקיד, חברה, מודעות
/api/bodacc/stats	מונה חי: סך המודעות, משפחות, הפרסום הוותיק והעדכני ביותר
/api/bodacc/openapi.json	מפרט OpenAPI מלא: 32 נקודות גישה, פרמטרים וסכמות
/api/bodacc/mcp	שרת MCP: אותו מידע, מוצג ככלי לסוכן או לעוזר בינה מלאכותית

אימות, מכסות ושגיאות

הנתונים הציבוריים אינם דורשים מפתח: קריאה מדפדפן או מסקריפט פועלת מיד. אימות באמצעות מפתח נוגע רק לנקודות הגישה המתועדות ככאלה (גישה לשדות מועשרים, נפח גבוה, שימוש מסחרי). התגובות עוקבות אחר קודי ה-HTTP הרגילים: 200 לתוצאה, 404 כאשר הישות אינה קיימת, 429 כאשר קצב הבקשות חרג, 5xx לשגיאה מצדנו. 429 אינו סירוב סופי: הוא רק מציין להאט, והשירות מגיב שוב ברגע שהקצב יורד.

קריאה אחת, שלוש שורות

אין צורך להתקין SDK, אין צורך ליצור חשבון כדי להתחיל. הנה חיפוש מודעות של הליך חדלות פירעון במחוז:

curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=75&limit=5"

# réponse : { "total": 1234, "annonces": [ { "id": "A2026...", "dateparution": "2026-10-23",
#   "familleavis": "collective", "commercant": "...", "registre": "..." } ] }

מה ה-API הזה מוסיף

שלושה הבדלים שחשובים כשמפתחים מוצר על גביו. העדכניות: ה-BODACC נטען בכל יום פרסום, מודעת בוקר זמינה בתוך השעה שלאחר פרסומה, בעוד שרוב השימושים החוזרים מציעים מסד נתונים המתעדכן פעם בשבוע. השפה: כל כרטיס קיים ב-20 שפות, מה שמאפשר לשרת משתמש יפני או ערבי בלי לתרגם את הנתונים בעצמך. העקביות: המודעות, החברות והמנהלים מקושרים זה לזה, מה שנמנע מלחבר ידנית SIREN שנמצא בטקסט חופשי. הגישה חינם לנתונים הציבוריים, ושרת ה-MCP מאפשר לסוכן בינה מלאכותית לשאול את מסד הנתונים בלי לכתוב שורת קוד.

שאלות נפוצות

האם ה-API של BODACC הוא בחינם?: כן לנתונים הציבוריים: מודעות, חברות, אנשים ומונים. ההצעות בתשלום נוגעות לנוחות ולניתוח (נפח, התראות, דוחות, גישה לשדות מועשרים), ולעולם לא לגישה הבסיסית למודעה שפורסמה בעיתון הרשמי.
מאין מגיעים הנתונים ובאיזו תדירות הם מתעדכנים?: מה-BODACC המתפרסם על ידי מנהלת המידע המשפטי והמנהלי, בתוספת מרשם SIRENE של INSEE לזהות החברות. הטעינה פועלת בכל יום פרסום: מודעת בוקר זמינה בתוך השעה שלאחר מכן, והמונים המוצגים על ידי ה-API מחושבים מחדש בכל מעבר.
מהו פורמט התגובות?: JSON, ב-UTF-8, עם תאריכים בפורמט ISO 8601. הסכומים ביורו, מספרי ה-SIREN בתשע ספרות ללא רווחים. אין פורמט קנייני, אין המרה לעשות.
האם יש מגבלת בקשות?: מוחל בלם לפי כתובת ולפי רשת כדי להגן על השירות: מעבר לקצב מסוים, התגובה היא 429 זמני ולא שגיאה. שימוש מוגבר ומוצהר (סוכן מזוהה, טווח כתובות מפורסם) אינו נבלם. הפרטים מופיעים בעמוד אימות ומגבלות.
האם אני יכול לצטט את הנתונים של BODACC.io במאמר או בתשובת בינה מלאכותית?: כן, ומוטב לצטט את המונים החיים מאשר להעתיק מספר מיושן: הכתובת /api/bodacc/stats מחזירה את הסכום הרגעי, וקובץ llms.txt מציין לסוכנים היכן למצוא אותו. זו הדרך היחידה להימנע מהכרזת נפח מיושן.

להעמיק

שישה עמודים מפרטים כל חלק: קריאה ראשונה, מודעות, חברות, אנשים ומדריך, אימות ומגבלות, סטטיסטיקות. הם נכתבו כדי להיקרא בסדר הזה כשמתחילים, ולהיות נבדקים לפי הצורך לאחר מכן.

Spécification interactive

Swagger UI openapi.json

התחלה מהירה עם API BODACCצעדים ראשונים עם API BODACC: גישה חינמית ב-open data, קריאה ראשונה, 46 endpoints, מפתח API, שגיאות ומגבלות.חיפוש פרסומי BODACCכל הפרמטרים של נקודת הקצה פרסומים ב-API של BODACC: מילת מפתח, משפחה, מחלקה, עיר, SIREN, תאריכים, פגינציה ודוגמאות curl.API עסקים: כרטיס SIRENחיפוש עסקים לפי שם או SIREN: מסנני NAF, מחוז, מצב, קריטריונים מורחבים (אתר, אימייל, מנהלים) דרך API BODACC.אנשים ומדריך BODACCכרטיסי אנשים (זהות, מינויים, חברות קשורות) ומדריך אנשי מקצוע מפרקים, נאמנים ומנהלים דרך API BODACC.סטטיסטיקות API BODACCמוני גלובליים, הודעות היום, סדרות 30 יום, חלוקה גיאוגרפית וממוצעי הפקדה דרך נקודות הקצה הסטטיסטיות של API BODACC.מפתח API BODACC : אימות ומגבלותגישה חינמית ללא מפתח, מפתחות API Pro ו-Enterprise, כותרות X-API-Key ו-Bearer, קודי שגיאה ומגבלות אנטי-דאמפ של API BODACC.

יש שאלה?

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