API 문서
BODACC API 기술 문서: endpoints, 매개변수, 예제 및 MCP 서버.
1분 만에 이해하는 BODACC API
BODACC API는 민사 및 상사 공고 공식 게시판에 게재된 법적 공고와 그 안에 등장하는 기업 및 인물 정보를 JSON 형식으로 제공합니다. 설립, 등록, 매각, 변경, 말소, 집단 절차, 재무제표 제출 등 각 공고는 게재 당일 원문 텍스트, 관련 SIREN, 언급된 인물과 함께 확인할 수 있습니다. 데이터베이스는 2008년 이후 5천만 건 이상의 공고와 SIRENE 등록부에 등록된 약 3천만 개 기업을 포함합니다.
주요 엔드포인트
필요한 대부분의 기능을 여섯 개 주소로 처리할 수 있습니다. 모두 JSON으로 응답하며 일반적인 페이지네이션 매개변수인 limit와 offset을 지원합니다.
| 주소 | 반환 내용 |
|---|---|
| /api/bodacc/annonces | 공고 검색: q, siren, famille, departement, date_debut, date_fin |
| /api/bodacc/entreprises/{siren} | SIREN별 기업 정보: 신원, 주소, 임원, 관련 공고 |
| /api/bodacc/personnes/{id} | 공고에 언급된 인물: 역할, 기업, 공고 |
| /api/bodacc/stats | 실시간 카운터: 전체 공고 수, 분류, 가장 오래된 및 최신 게재일 |
| /api/bodacc/openapi.json | 전체 OpenAPI 명세: 32개 엔드포인트, 매개변수 및 스키마 |
| /api/bodacc/mcp | MCP 서버: 동일한 데이터를 AI 에이전트 또는 어시스턴트용 도구로 제공 |
인증, 할당량 및 오류
공개 데이터에는 키가 필요하지 않습니다. 브라우저나 스크립트에서 호출하면 즉시 작동합니다. 키 검증은 그렇게 문서화된 엔드포인트(강화된 필드 접근, 높은 볼륨, 상업적 사용)에만 적용됩니다. 응답은 일반적인 HTTP 코드를 따릅니다: 결과가 있으면 200, 엔티티가 없으면 404, 요청 속도가 초과되면 429, 서버 측 오류면 5xx입니다. 429는 영구적인 거부가 아니라 속도를 늦추라는 의미이며, 속도가 다시 낮아지면 서비스가 다시 응답합니다.
한 번의 호출, 세 줄의 코드
시작하기 위해 설치할 SDK도, 생성할 계정도 없습니다. 다음은 특정 지역의 집단 절차 공고를 검색하는 예입니다:
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=75&limit=5"
# réponse : { "total": 1234, "annonces": [ { "id": "A2026...", "dateparution": "2026-10-23",
# "familleavis": "collective", "commercant": "...", "registre": "..." } ] }이 API가 추가로 제공하는 것
이 API를 기반으로 제품을 만들 때 중요한 세 가지 차이점이 있습니다. 최신성: BODACC는 게재일마다 수집되므로 아침 공고는 게시 후 한 시간 이내에 제공되는 반면, 대부분의 재사용 서비스는 주 단위로 업데이트된 데이터베이스를 제공합니다. 언어: 각 정보가 20개 언어로 제공되어 데이터를 직접 번역하지 않고도 일본어나 아랍어 사용자에게 서비스할 수 있습니다. 일관성: 공고, 기업, 임원이 서로 연결되어 있어 자유 텍스트에서 발견한 SIREN을 수동으로 다시 연결할 필요가 없습니다. 공개 데이터에 대한 접근은 무료이며, MCP 서버를 통해 AI 에이전트가 코드 한 줄 없이 데이터베이스를 조회할 수 있습니다.
자주 묻는 질문
- BODACC API는 무료인가요?
- 공개 데이터(공고, 기업, 인물, 카운터)에 대해서는 무료입니다. 유료 요금제는 편의성과 분석(볼륨, 알림, 보고서, 강화된 필드 접근)에 관한 것이며, 공식 게시판에 게재된 공고에 대한 기본 접근은 결코 유료가 아닙니다.
- 데이터는 어디에서 오며 얼마나 자주 업데이트되나요?
- 법률 및 행정 정보국이 발행하는 BODACC와 기업 신원 확인을 위한 INSEE의 SIRENE 등록부에서 가져옵니다. 수집은 게재일마다 실행되므로 아침 공고는 한 시간 이내에 제공되며, API에서 노출되는 카운터는 매 실행 시 다시 계산됩니다.
- 응답 형식은 무엇인가요?
- UTF-8 JSON이며 날짜는 ISO 8601 형식입니다. 금액은 유로, SIREN은 공백 없는 9자리 숫자입니다. 독점 형식이 없고 변환할 필요도 없습니다.
- 요청 제한이 있나요?
- 서비스 보호를 위해 주소 및 네트워크별로 제한이 적용됩니다. 특정 속도를 초과하면 오류 대신 일시적인 429 응답이 반환됩니다. 식별된 에이전트, 공개된 주소 범위 등 지속적이고 신고된 사용에는 제한이 적용되지 않습니다. 자세한 내용은 인증 및 제한 페이지에 나와 있습니다.
- BODACC.io의 수치를 기사나 AI 응답에 인용할 수 있나요?
- 네, 그리고 오래된 수치를 복사하기보다 실시간 카운터를 인용하는 것이 좋습니다. /api/bodacc/stats 주소는 현재 총계를 반환하며, llms.txt 파일은 에이전트에게 해당 정보를 어디서 찾을 수 있는지 알려줍니다. 이것이 만료된 볼륨을 발표하지 않는 유일한 방법입니다.
더 알아보기
여섯 페이지에서 각 부분을 자세히 설명합니다: 첫 호출, 공고, 기업, 인물 및 디렉터리, 인증 및 제한, 통계. 시작할 때는 이 순서대로 읽고, 이후에는 필요에 따라 참조하도록 작성되었습니다.
Spécification interactive
질문이 있으신가요?
저희 팀이 신속하게 답변해 드립니다. 요청은 API 카테고리와 함께 전달됩니다.