Быстрый старт API BODACC

Открытые данные и бесплатность

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 и лучшие практики