Czy API BODACC jest darmowe?

Tak, API BODACC jest darmowe i otwarte na dane publiczne: ogłoszenia, firmy, osoby, katalog i statystyki, bez klucza i subskrypcji. Oferty Pro i Enterprise dodają klucze API i priorytetowy dostęp.

Czy potrzebny jest klucz API?

Nie, dostęp publiczny nie wymaga klucza. Klucze API (prefiks sk_bodacc_) są dostarczane z ofertami Pro i Enterprise dla endpointów, które ich wymagają, w sekcji Moje konto, następnie API.

Jakie są limity API?

limit jest ograniczony do 500 wyników na zapytanie, a offset do 10 000. Katalog jest ograniczony do 200 stron po 100. W przypadku błędu 429 należy przestrzegać nagłówka Retry-After.

Czy dane są w czasie rzeczywistym?

Tak, ogłoszenia są publikowane natychmiast po ukazaniu się w BODACC, podczas gdy plik historyczny jest pobierany raz dziennie.

Szybki start API BODACC : BODACC.io

Open data i darmowy dostęp

API BODACC jest darmowe i otwarte: zapewnia dostęp w modelu open data i w czasie rzeczywistym do pełnej bazy danych Biuletynu Urzędowego — 11,3 mln ogłoszeń, 6,7 mln firm, 1,9 mln osób (dane na żywo stats/counts). Podczas gdy historyczny plik BODACC pobierany jest raz dziennie, API udostępnia ogłoszenia natychmiast po publikacji, bez klucza dla danych publicznych.

# Dokładne liczniki, bez klucza
curl "https://bodacc.io/api/bodacc/stats/counts"

Pierwsze wywołanie

Publiczne API BODACC jest dostępne bez klucza dla danych. Najczęściej używany endpoint wyszukuje ogłoszenia po słowie kluczowym:

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

Odpowiedź (fragment):

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

Pełna specyfikacja

API dokumentuje 46 endpointów (zweryfikowane na żywym OpenAPI). Dwa sposoby na ich przeglądanie:

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

Główne endpointy

Endpoint	Opis
`GET /api/bodacc/annonces`	Wyszukiwanie ogłoszeń (słowo kluczowe, rodzina, miasto, departament, SIREN, daty)
`GET /api/bodacc/annonces/{id}`	Szczegóły ogłoszenia + powiązania (firma, osoby)
`GET /api/bodacc/entreprises`	Wyszukiwanie firm (nazwa, SIREN, NAF, status, filtry rozszerzone)
`GET /api/bodacc/entreprises/{siren}`	Pełna karta SIREN
`GET /api/bodacc/personnes/{id}`	Karta osoby (tożsamość + mandaty)
`GET /api/bodacc/annuaire/{role}`	Katalog likwidatorów, pełnomocników, administratorów
`GET /api/bodacc/stats/counts`	Liczniki globalne (ogłoszenia, firmy, osoby)

Uwierzytelnianie

Dostęp publiczny nie wymaga żadnego klucza. W ofertach Pro i Enterprise udokumentowane endpointy akceptują klucz API:

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

Klucz można również przekazać jako Authorization: Bearer sk_bodacc_.... Nieprawidłowy lub unieważniony klucz zwraca 401.

Błędy

API zwraca standardowe błędy HTTP z treścią JSON opisującą problem:

400: nieprawidłowy parametr
401: nieprawidłowy lub unieważniony klucz API
404: zasób nieznaleziony
429: zbyt wiele żądań — przestrzegaj nagłówka Retry-After

Limity

limit: od 1 do 500 na żądanie
offset: do 10 000 (paginacja anty-dump)
Dane aktualizowane są w czasie rzeczywistym po każdej publikacji BODACC
Wyszukiwanie po rodzinie wykorzystuje dokładne, zmaterializowane sumy (brak total_estime); łączone wyszukiwania tekstowe mogą zwracać sumę szacunkową ("total_estime": true)

Dalsze kroki

Wyszukiwanie ogłoszeń: wszystkie parametry wyszukiwania
Karty firm: wyszukiwanie i karta SIREN
Osoby i katalog: kierownicy i profesjonaliści
Statystyki: liczniki i serie
Uwierzytelnianie i limity: klucze API i dobre praktyki

Szybki start API BODACC