BODACC 공고 검색 API
공고 검색
GET /api/bodacc/annonces 엔드포인트는 관보(Bulletin Officiel des Annonces Civiles et Commerciales)를 조회합니다: 설립, 양도, 변경, 말소, 집단 절차 및 재무제표 제출을 각 게재 후 실시간으로 제공합니다.
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"