API文档

一分钟了解 BODACC API

BODACC API 以 JSON 格式提供在《民事与商事公告官方公报》上发布的法定公告，以及其中出现的企业和个人。创建、注册、出售、变更、注销、集体程序、账目提交：每条公告在发布当天即可获取，包含原始文本、相关 SIREN 和提及的人员。该数据库收录了自 2008 年以来的超过 5000 万条公告和近 3000 万家在 SIRENE 注册的企业。

入口点

六个地址足以覆盖基本需求。所有地址均以 JSON 响应，并接受常规分页参数：limit 和 offset。

认证、配额和错误

公开数据无需密钥：从浏览器或脚本发起的调用可立即使用。密钥验证仅适用于明确标注的入口点（访问增强字段、高流量、商业用途）。响应遵循常规 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 的额外价值

构建产品时至关重要的三个差异。时效性：BODACC 在每个发布日被摄取，早上的公告在发布后一小时内即可获取，而大多数复用方案提供的是每周更新的数据库。语言：每个档案支持 20 种语言，无需自行翻译数据即可服务日本或阿拉伯用户。一致性：公告、企业和负责人相互关联，避免手动拼接自由文本中的 SIREN。公开数据免费访问，MCP 服务器让 AI 代理无需编写代码即可查询数据库。

常见问题

BODACC API 是免费的吗？

公开数据免费：公告、企业、个人和计数器。付费方案侧重于便利性和分析（流量、警报、报告、增强字段访问），而非对官方公报上已发布公告的基本访问。

数据来源是什么，更新频率如何？

来自法律与行政信息局发布的 BODACC，辅以 INSEE 的 SIRENE 注册库中的企业身份信息。摄取在每个发布日运行：早上的公告在一小时内可用，API 暴露的计数器在每次运行时重新计算。

响应格式是什么？

JSON，UTF-8 编码，日期为 ISO 8601 格式。金额以欧元为单位，SIREN 为九位数字无空格。无专有格式，无需转换。

有请求限制吗？

为保护服务，按地址和网络实施限流：超过一定频率时，返回临时 429 而非错误。已声明的高频使用（已识别代理、已发布地址范围）不受限流。详情见认证与限制页面。

我可以在文章或 AI 回答中引用 BODACC.io 的数据吗？

可以，最好引用实时计数器而非复制过时数字：/api/bodacc/stats 地址返回当前总数，llms.txt 文件指示代理在哪里找到它。这是避免公布过期数据的唯一方法。

深入了解

六个页面详细说明每个部分：首次调用、公告、企业、个人和目录、认证与限制、统计。它们按顺序编写，适合入门时阅读，之后可按需查阅。