BODACC API快速入门指南
开放数据与免费
BODACC API 免费且开放：它以开放数据形式实时提供《官方公报》完整数据库的访问权限 — 1130 万条公告、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 返回标准 HTTP 错误，并附带 JSON 响应体详细说明问题：
400：参数无效401：API 密钥无效或已撤销404：资源未找到429：请求过多 — 请遵守Retry-After响应头
限制
limit：每次请求介于 1 到 500 之间offset：最大 10 000（防批量抓取分页）- 数据在每次 BODACC 发布后实时更新
- 按类别搜索使用精确物化总数（无
total_estime）；组合文本搜索可能返回估算总数（"total_estime": true）