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/mcpMCP 서버: 동일한 데이터를 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 카테고리와 함께 전달됩니다.