BODACC公告を検索するAPIガイド
お知らせの検索
GET /api/bodacc/annonces エンドポイントは、官報（Bulletin Officiel des Annonces Civiles et Commerciales）を照会します：設立、売却、変更、抹消、集団手続、および各掲載後のリアルタイムでの決算報告。
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"
検索パラメータ
| パラメータ | 説明 | 例 |
|---|---|---|
q | 事業者名または市区町村内のキーワード | q=dupont |
typeavis | お知らせの種類 | typeavis=A（設立） |
famille | アナウンスのファミリー | famille=liquidation |
departement | 県コード | departement=33 |
ville | 市区町村（アクセントの有無は問わない） | ville=LYON |
date_debut | 掲載開始日（ISO形式） | date_debut=2026-07-01 |
date_fin | 掲載終了日（ISO形式） | date_fin=2026-07-31 |
siren | SIRENによるフィルタ（登録簿） | siren=123456789 |
limit | 結果数（1〜500） | limit=50 |
offset | ページネーション（0〜10,000） | offset=50 |
アナウンスのファミリー
主なファミリー：creation（設立）、immatriculation（登録）、vente（売却）、modification（変更）、radiation（抹消）、collective（集団手続）、conciliation（調停）、retablissement（再建）、dpc（決算報告）、divers（その他）。
# 33県の今月の清算
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"
ページネーションと制限
limit：リクエストあたり1〜500（デフォルトは20）offset：最大10,000 — それを超えると、結果は意図的に切り捨てられます（データ一括取得防止）totalフィールドは結果の総数を示します。total_estime: trueは、PostgreSQLプランナーによる推定総数であることを示します（テキスト検索の組み合わせ）— 単純なフィルタ（ファミリー、県）では正確な総数が使用されます
レスポンスの読み方
各結果には以下が含まれます：id、dateparution、numeroannonce、typeavis、typeavis_lib、familleavis、familleavis_lib、numerodepartement、departement_nom_officiel、commercant、ville、cp、tribunal、slug、registre。
アナウンスの完全な詳細（企業と人物の関係を含む）は、GET /api/bodacc/annonces/{id} で取得できます：
curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"
完全な例
ボルドーにおける過去30日間の事業者の抹消を検索：
curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"