Search BODACC announcements
Пошук оголошень
Endpoint GET /api/bodacc/annonces запитує Офіційний бюлетень цивільних і комерційних оголошень: створення, продажі, зміни, анулювання, процедури банкрутства та подання звітності, у реальному часі після кожної публікації.
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
Параметри пошуку
| Параметр | Опис | Приклад |
|---|---|---|
q | Ключове слово у назві підприємця або місті | q=dupont |
typeavis | Тип повідомлення | typeavis=A (створення) |
famille | Сім'я оголошень | famille=liquidation |
departement | Код департаменту | departement=33 |
ville | Місто (без урахування регістру та акцентів) | ville=LYON |
date_debut | Публікація з дати (ISO) | date_debut=2026-07-01 |
date_fin | Публікація до дати (ISO) | date_fin=2026-07-31 |
siren | Фільтр за SIREN (реєстр) | siren=123456789 |
limit | Кількість результатів (від 1 до 500) | limit=50 |
offset | Пагінація (від 0 до 10 000) | offset=50 |
Сім'ї оголошень
Основні сім'ї: creation, immatriculation, vente, modification, radiation, collective (процедури банкрутства), conciliation, retablissement, dpc (подання звітності), divers.
# Ліквідації за місяць у департаменті 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"
Пагінація та обмеження
limit: від 1 до 500 на запит (за замовчуванням 20)offset: до 10 000 — понад цю межу результати навмисно обрізаються (захист від вивантаження даних)- Поле
totalпоказує загальну кількість результатів;total_estime: trueвказує на оціночний підсумок від планувальника PostgreSQL (комбіновані текстові пошуки) — прості фільтри (сім'я, департамент) використовують точні матеріалізовані підсумки
Читання відповіді
Кожен результат містить: id, dateparution, numeroannonce, typeavis, typeavis_lib, familleavis, familleavis_lib, numerodepartement, departement_nom_officiel, commercant, ville, cp, tribunal, slug, registre.
Повну деталізацію оголошення (з відносинами підприємства та осіб) можна отримати через GET /api/bodacc/annonces/{id}:
curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"
Повний приклад
Пошук анулювань підприємців у Бордо за останні 30 днів:
curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"
Подальші кроки
- Швидкий старт : перший запит і помилки
- Картки підприємств : перехід від оголошення до картки SIREN
- Автентифікація та обмеження : ключі API та квоти