Wyszukiwanie ogłoszeń BODACC
Wyszukiwanie ogłoszeń
Endpoint GET /api/bodacc/annonces przeszukuje Biuletyn Urzędowy Ogłoszeń Cywilnych i Handlowych: utworzenia, sprzedaże, zmiany, wykreślenia, postępowania zbiorowe i depozyty sprawozdań finansowych, w czasie rzeczywistym po każdej publikacji.
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
Parametry wyszukiwania
| Parametr | Opis | Przykład |
|---|---|---|
q | Słowo kluczowe w nazwie przedsiębiorcy lub mieście | q=dupont |
typeavis | Rodzaj ogłoszenia | typeavis=A (utworzenie) |
famille | Rodzina ogłoszeń | famille=liquidation |
departement | Kod departamentu | departement=33 |
ville | Miasto (bez rozróżniania akcentów) | ville=LYON |
date_debut | Publikacja od (ISO) | date_debut=2026-07-01 |
date_fin | Publikacja do (ISO) | date_fin=2026-07-31 |
siren | Filtr według SIREN (rejestr) | siren=123456789 |
limit | Liczba wyników (1 do 500) | limit=50 |
offset | Paginacja (0 do 10 000) | offset=50 |
Rodziny ogłoszeń
Główne rodziny: creation, immatriculation, vente, modification, radiation, collective (postępowania zbiorowe), conciliation, retablissement, dpc (depozyty sprawozdań finansowych), divers.
# Likwidacje w tym miesiącu w departamencie 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"
Paginacja i limity
limit: od 1 do 500 na zapytanie (domyślnie 20)offset: do 10 000 — powyżej tej wartości wyniki są celowo przycinane (ochrona przed zrzutem danych)- Pole
totalpodaje całkowitą liczbę wyników;total_estime: trueoznacza szacunkową liczbę obliczoną przez planista PostgreSQL (połączone wyszukiwania tekstowe) — proste filtry (rodzina, departament) używają dokładnych, zmaterializowanych liczb
Odczyt odpowiedzi
Każdy wynik zawiera: id, dateparution, numeroannonce, typeavis, typeavis_lib, familleavis, familleavis_lib, numerodepartement, departement_nom_officiel, commercant, ville, cp, tribunal, slug, registre.
Pełne szczegóły ogłoszenia (z relacjami do przedsiębiorstwa i osób) można pobrać przez GET /api/bodacc/annonces/{id}:
curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"
Kompletny przykład
Wyszukaj wykreślenia przedsiębiorców w Bordeaux z ostatnich 30 dni:
curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"
Dalsze kroki
- Szybki start: pierwsze wywołanie i błędy
- Karty przedsiębiorstw: przejście od ogłoszenia do karty SIREN
- Uwierzytelnianie i limity: klucze API i limity zapytań