BODACC API는 무료인가요?

네, BODACC API는 무료이며 공개 데이터인 공고, 기업, 개인, 디렉토리 및 통계에 키나 구독 없이 접근할 수 있습니다. Pro 및 Enterprise 요금제는 API 키와 우선 접근 권한을 제공합니다.

API 키가 필요한가요?

아니요, 공개 접근에는 키가 필요 없습니다. API 키(접두사 sk_bodacc_)는 Pro 및 Enterprise 요금제에서 해당 엔드포인트에 제공되며, 내 계정의 API 메뉴에서 확인할 수 있습니다.

API 사용 한도는 어떻게 되나요?

limit는 요청당 최대 500개, offset은 10,000개로 제한됩니다. 디렉토리는 100개씩 200페이지로 제한됩니다. 429 오류 발생 시 Retry-After 헤더를 준수하세요.

데이터는 실시간으로 제공되나요?

네, 공고는 BODACC에 게재되는 즉시 노출되며, 과거 데이터 파일은 하루에 한 번 다운로드할 수 있습니다.

BODACC API 빠른 시작 가이드 : BODACC.io

오픈 데이터 및 무료 이용

BODACC API는 무료이며 개방형입니다: 공식 게시판의 전체 데이터베이스에 오픈 데이터 및 실시간으로 액세스할 수 있습니다 — 1,130만 건의 공고, 670만 개의 기업, 190만 명의 인물 (실시간 수치 stats/counts). 기존 BODACC 파일이 하루에 한 번 다운로드되는 반면, API는 공고를 게재 즉시 노출하며, 공개 데이터에는 키가 필요 없습니다.

# 정확한 카운터, 키 없이
curl "https://bodacc.io/api/bodacc/stats/counts"

첫 호출

공개 BODACC API는 데이터에 키 없이 접근할 수 있습니다. 가장 많이 사용되는 엔드포인트는 키워드로 공고를 검색합니다:

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개의 엔드포인트를 문서화합니다 (라이브 OpenAPI에서 확인). 탐색 방법은 두 가지입니다:

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

주요 엔드포인트

엔드포인트	설명
`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 요금제의 경우, 문서화된 엔드포인트는 API 키를 허용합니다:

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

키는 Authorization: Bearer sk_bodacc_...로도 전달할 수 있습니다. 유효하지 않거나 폐기된 키는 401을 반환합니다.

오류

API는 문제를 설명하는 JSON 본문과 함께 표준 HTTP 오류를 반환합니다:

400: 잘못된 매개변수
401: 유효하지 않거나 폐기된 API 키
404: 리소스를 찾을 수 없음
429: 요청이 너무 많음 — Retry-After 헤더를 준수하세요

제한 사항

limit: 요청당 1에서 500 사이
offset: 최대 10,000 (대량 다운로드 방지 페이지네이션)
데이터는 BODACC 게재 후 실시간으로 업데이트됩니다
유형별 검색은 정확한 구체화된 합계를 사용합니다 (total_estime 없음); 결합된 텍스트 검색은 추정 합계를 반환할 수 있습니다 ("total_estime": true)

더 알아보기

공고 검색: 모든 검색 매개변수
기업 프로필: 검색 및 SIREN 프로필
인물 및 디렉토리: 임원 및 전문가
통계: 카운터 및 시리즈
인증 및 제한 사항: API 키 및 모범 사례

BODACC API 빠른 시작 가이드