BODACC APIクイックスタートガイド

オープンデータと無料利用

BODACC APIは無料かつオープンです。官報の完全なデータベースにオープンデータとしてリアルタイムでアクセスできます。1,130万件の公告、670万社の企業、190万人の人物（ライブのstats/countsによる数値）。従来のBODACCファイルが1日1回ダウンロードされるのに対し、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で確認済み）。探索方法は2つあります：

• 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）が返されることがあります

さらに詳しく

• 公告の検索：すべての検索パラメータ
• 企業ファイル：検索とSIRENファイル
• 人物と名簿：役員と専門家
• 統計：カウンターと系列
• 認証と制限：APIキーとベストプラクティス