Apakah API BODACC gratis?

Ya, API BODACC gratis dan terbuka untuk data publik: pengumuman, perusahaan, orang, direktori dan statistik, tanpa kunci dan tanpa langganan. Paket Pro dan Enterprise menambahkan kunci API dan akses prioritas.

Apakah saya perlu kunci API?

Tidak, akses publik tidak memerlukan kunci. Kunci API (prefiks sk_bodacc_) disediakan dengan paket Pro dan Enterprise untuk endpoint yang memerlukannya, melalui Akun saya lalu API.

Apakah datanya realtime?

Ya, pengumuman ditampilkan segera setelah diterbitkan di BODACC, sedangkan file historis diunduh hanya sekali sehari.

limit dibatasi hingga 500 hasil per permintaan dan offset hingga 10 000. Direktori dibatasi hingga 200 halaman dari 100. Jika 429, hormati header Retry-After.

Panduan Cepat API BODACC : BODACC.io

Data Terbuka dan Gratis

API BODACC gratis dan terbuka: memberikan akses data terbuka secara real-time ke basis data lengkap Buletin Resmi — 11,3 juta pengumuman, 6,7 juta perusahaan, 1,9 juta orang (angka langsung stats/counts). Sementara file BODACC historis diunduh sekali sehari, API menampilkan pengumuman segera setelah diterbitkan, tanpa kunci untuk data publik.

# Penghitung akurat, tanpa kunci
curl "https://bodacc.io/api/bodacc/stats/counts"

Panggilan Pertama

API publik BODACC dapat diakses tanpa kunci untuk data. Endpoint yang paling banyak digunakan mencari pengumuman berdasarkan kata kunci:

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

Respons (cuplikan):

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

Spesifikasi Lengkap

API mendokumentasikan 46 endpoint (terverifikasi pada OpenAPI langsung). Dua cara untuk menjelajahinya:

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

Endpoint Utama

Endpoint	Deskripsi
`GET /api/bodacc/annonces`	Pencarian pengumuman (kata kunci, keluarga, kota, departemen, SIREN, tanggal)
`GET /api/bodacc/annonces/{id}`	Detail pengumuman + relasi (perusahaan, orang)
`GET /api/bodacc/entreprises`	Pencarian perusahaan (nama, SIREN, NAF, status, filter diperkaya)
`GET /api/bodacc/entreprises/{siren}`	Profil lengkap SIREN
`GET /api/bodacc/personnes/{id}`	Profil orang (identitas + mandat)
`GET /api/bodacc/annuaire/{role}`	Direktori likuidator, kuasa, administrator
`GET /api/bodacc/stats/counts`	Penghitung global (pengumuman, perusahaan, orang)

Autentikasi

Akses publik tidak memerlukan kunci apa pun. Untuk penawaran Pro dan Enterprise, endpoint yang didokumentasikan menerima kunci API:

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

Kunci juga dapat diteruskan melalui Authorization: Bearer sk_bodacc_.... Kunci yang tidak valid atau dicabut akan mengembalikan 401.

Kesalahan

API mengembalikan kesalahan HTTP standar dengan badan JSON yang merinci masalah:

400: parameter tidak valid
401: kunci API tidak valid atau dicabut
404: sumber daya tidak ditemukan
429: terlalu banyak permintaan — hormati header Retry-After

Batasan

limit: antara 1 dan 500 per permintaan
offset: hingga 10.000 (paginasi anti-dump)
Data diperbarui secara real-time setelah setiap penerbitan BODACC
Pencarian berdasarkan keluarga menggunakan total akurat yang terwujud (total_estime tidak ada); pencarian teks gabungan dapat mengembalikan total estimasi ("total_estime": true)

Melangkah Lebih Jauh

Mencari pengumuman: semua parameter pencarian
Profil perusahaan: pencarian dan profil SIREN
Orang dan direktori: direktur dan profesional
Statistik: penghitung dan seri
Autentikasi dan batasan: kunci API dan praktik terbaik

Panduan Cepat API BODACC