क्या BODACC API मुफ्त है?

हाँ, BODACC API मुफ्त है और सार्वजनिक डेटा पर खुला है: विज्ञापन, कंपनियाँ, व्यक्ति, निर्देशिका और आँकड़े, बिना कुंजी या सदस्यता के। Pro और Enterprise योजनाएँ API कुंजियाँ और प्राथमिक पहुँच जोड़ती हैं।

क्या API कुंजी आवश्यक है?

नहीं, सार्वजनिक पहुँच के लिए कोई कुंजी नहीं चाहिए। API कुंजियाँ (उपसर्ग sk_bodacc_) Pro और Enterprise योजनाओं के साथ उन endpoints के लिए दी जाती हैं जिन्हें इसकी आवश्यकता होती है, Mon compte फिर API से।

API की सीमाएँ क्या हैं?

limit प्रति अनुरोध 500 परिणामों तक सीमित है और offset 10 000 तक। निर्देशिका 100 की 200 पृष्ठों तक सीमित है। 429 पर, Retry-After हेडर का पालन करें।

क्या डेटा वास्तविक समय में है?

हाँ, विज्ञापन BODACC में प्रकाशन पर ही उजागर होते हैं, जबकि ऐतिहासिक फ़ाइल दिन में एक बार डाउनलोड होती है।

BODACC API त्वरित आरंभ : BODACC.io

ओपन डेटा और निःशुल्कता

BODACC API निःशुल्क और खुली है: यह ओपन डेटा और वास्तविक समय में आधिकारिक बुलेटिन के पूर्ण डेटाबेस तक पहुंच प्रदान करती है — 11.3 मिलियन विज्ञापन, 6.7 मिलियन कंपनियां, 1.9 मिलियन व्यक्ति (लाइव आंकड़े stats/counts)। जहां ऐतिहासिक BODACC फ़ाइल दिन में एक बार डाउनलोड होती है, वहीं API विज्ञापनों को प्रकाशन के तुरंत बाद उजागर करती है, सार्वजनिक डेटा के लिए बिना कुंजी के।

# सटीक काउंटर, बिना कुंजी के
curl "https://bodacc.io/api/bodacc/stats/counts"

पहला कॉल

सार्वजनिक BODACC API डेटा के लिए बिना कुंजी के सुलभ है। सबसे अधिक उपयोग किया जाने वाला एंडपॉइंट कीवर्ड द्वारा विज्ञापन खोजता है:

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 समस्या का विवरण देने वाले JSON बॉडी के साथ मानक HTTP त्रुटियां लौटाता है:

400: अमान्य पैरामीटर
401: अमान्य या रद्द की गई API कुंजी
404: संसाधन नहीं मिला
429: बहुत अधिक अनुरोध — Retry-After हेडर का सम्मान करें

सीमाएं

limit: प्रति अनुरोध 1 से 500 के बीच
offset: 10,000 तक (एंटी-डंप पेजिनेशन)
डेटा BODACC के प्रत्येक प्रकाशन के बाद वास्तविक समय में अपडेट होता है
परिवार द्वारा खोज सटीक भौतिक कुल का उपयोग करती है (total_estime अनुपस्थित); संयुक्त टेक्स्ट खोज अनुमानित कुल लौटा सकती है ("total_estime": true)

आगे बढ़ें

विज्ञापन खोजें: सभी खोज पैरामीटर
कंपनी फ़ाइलें: खोज और SIREN फ़ाइल
व्यक्ति और निर्देशिका: निदेशक और पेशेवर
सांख्यिकी: काउंटर और श्रृंखलाएं
प्रमाणीकरण और सीमाएं: API कुंजियां और सर्वोत्तम अभ्यास

BODACC API त्वरित आरंभ