BODACC API ücretsiz mi?

Evet, BODACC API kamu verileri üzerinde ücretsiz ve açıktır: ilanlar, şirketler, kişiler, rehber ve istatistikler, anahtar veya abonelik olmadan. Pro ve Enterprise paketleri API anahtarları ve öncelikli erişim ekler.

API anahtarı gerekli mi?

Hayır, genel erişim anahtar gerektirmez. API anahtarları (sk_bodacc_ öneki) Pro ve Enterprise paketleriyle, gerektiren uç noktalar için Hesabım ardından API bölümünden sağlanır.

API sınırları nelerdir?

limit istek başına 500 sonuçla, offset ise 10 000 ile sınırlıdır. Rehber 100'er sayfalık 200 sayfayla sınırlıdır. 429 durumunda Retry-After başlığına uyun.

Veriler gerçek zamanlı mı?

Evet, ilanlar BODACC'de yayınlandıkları anda sunulur; geçmiş dosyası ise günde bir kez indirilir.

BODACC API Hızlı Başlangıç Rehberi : BODACC.io

Açık Veri ve Ücretsizlik

BODACC API'si ücretsiz ve açıktır: Resmi Bülten'in tam veri tabanına açık veri ve gerçek zamanlı erişim sağlar — 11,3 milyon ilan, 6,7 milyon işletme, 1,9 milyon kişi (canlı sayılar stats/counts). Tarihsel BODACC dosyası günde bir kez indirilirken, API ilanları yayınlandıkları anda sunar; kamu verileri için anahtar gerekmez.

# Kesin sayaçlar, anahtar olmadan
curl "https://bodacc.io/api/bodacc/stats/counts"

İlk Çağrı

Kamuya açık BODACC API'sine veriler için anahtar olmadan erişilebilir. En çok kullanılan uç nokta, anahtar kelimeye göre ilan arar:

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

Yanıt (alıntı):

{
  "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
}

Tam Spesifikasyon

API, 46 uç noktayı belgeler (canlı OpenAPI üzerinde doğrulanmıştır). Bunları keşfetmenin iki yolu:

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

Ana Uç Noktalar

Uç Nokta	Açıklama
`GET /api/bodacc/annonces`	İlan arama (anahtar kelime, aile, şehir, departman, SIREN, tarihler)
`GET /api/bodacc/annonces/{id}`	Bir ilanın detayı + ilişkiler (işletme, kişiler)
`GET /api/bodacc/entreprises`	İşletme arama (ad, SIREN, NAF, durum, zenginleştirilmiş filtreler)
`GET /api/bodacc/entreprises/{siren}`	Bir SIREN'in tam dosyası
`GET /api/bodacc/personnes/{id}`	Kişi dosyası (kimlik + görevler)
`GET /api/bodacc/annuaire/{role}`	Tasfiye memurları, vekiller, yöneticiler rehberi
`GET /api/bodacc/stats/counts`	Genel sayaçlar (ilanlar, işletmeler, kişiler)

Kimlik Doğrulama

Kamu erişimi herhangi bir anahtar gerektirmez. Pro ve Enterprise teklifleri için belgelenen uç noktalar bir API anahtarı kabul eder:

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

Anahtar ayrıca Authorization: Bearer sk_bodacc_... olarak da iletilir. Geçersiz veya iptal edilmiş bir anahtar 401 döndürür.

Hatalar

API, sorunu detaylandıran JSON gövdesiyle standart HTTP hataları döndürür:

400: geçersiz parametre
401: geçersiz veya iptal edilmiş API anahtarı
404: kaynak bulunamadı
429: çok fazla istek — Retry-After başlığına uyun

Sınırlar

limit: istek başına 1 ile 500 arasında
offset: 10 000'e kadar (anti-dump sayfalama)
Veriler, BODACC'in her yayınından sonra gerçek zamanlı olarak güncellenir
Aileye göre arama, gerçekleştirilmiş kesin toplamları kullanır (total_estime yok); birleşik metin aramaları tahmini bir toplam döndürebilir ("total_estime": true)

Daha Fazlası

İlan arama: tüm arama parametreleri
İşletme dosyaları: arama ve SIREN dosyası
Kişiler ve rehber: yöneticiler ve profesyoneller
İstatistikler: sayaçlar ve seriler
Kimlik doğrulama ve sınırlar: API anahtarları ve iyi uygulamalar

BODACC API Hızlı Başlangıç Rehberi