Чи безкоштовний API BODACC?

Так, API BODACC безкоштовний і відкритий для публічних даних: оголошення, підприємства, особи, довідник і статистика, без ключа та без підписки. Плани Pro та Enterprise додають ключі API та пріоритетний доступ.

Чи потрібен ключ API?

Ні, публічний доступ не потребує ключа. Ключі API (префікс sk_bodacc_) надаються з планами Pro та Enterprise для кінцевих точок, які їх вимагають, через Мій обліковий запис, потім API.

Які обмеження API?

limit обмежено 500 результатами на запит, offset до 10 000. Довідник обмежений 200 сторінками по 100. У разі 429 дотримуйтеся заголовка Retry-After.

Чи дані в реальному часі?

Так, оголошення публікуються одразу після появи в BODACC, тоді як історичний файл завантажується лише раз на день.

BODACC API Quick Start Guide : BODACC.io

Відкриті дані та безкоштовність

API BODACC є безкоштовним та відкритим: воно надає доступ у форматі open data та в реальному часі до повної бази даних Офіційного бюлетеня — 11,3 мільйона оголошень, 6,7 мільйона підприємств, 1,9 мільйона осіб (актуальні показники stats/counts). Тоді як історичний файл BODACC завантажується раз на день, API публікує оголошення одразу після їх виходу, без ключа для публічних даних.

# Точні лічильники, без ключа
curl "https://bodacc.io/api/bodacc/stats/counts"

Перший запит

Публічне API BODACC доступне без ключа для даних. Найбільш використовуваний endpoint шукає оголошення за ключовим словом:

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 endpoints (перевірено на живому OpenAPI). Два способи їх дослідити:

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

Основні endpoints

Endpoint	Опис
`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 задокументовані endpoints приймають ключ 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)

Подальші кроки

Пошук оголошень: усі параметри пошуку
Картки підприємств: пошук та картка SIREN
Особи та довідник: керівники та професіонали
Статистика: лічильники та серії
Автентифікація та обмеження: ключі API та кращі практики

BODACC API Quick Start Guide