REST API リファレンス
HOJIN DB の法人検索・法人プロファイル API。すべてのデータ API は X-API-Key が必要です。beta_free の上限は 100 requests per day、10 requests per minute です。上限超過時は 429 と Retry-After ヘッダを返します。
認証
認証が必要なエンドポイントには X-API-Key ヘッダーを付けてください（developers ページで発行した API キー）。未発行の方は API キーの発行 をご覧ください。Web 閲覧（HTML ページ）は認証不要です。
エンドポイント（現在 3 件）
/v1/corp/{corporate_number}
認証必須
法人番号で法人プロファイルを取得
| パラメータ | 場所 | 必須 | 説明 |
|---|---|---|---|
corporate_number |
path | 必須 | 13桁の法人番号 |
200 成功
400 入力値が不正
401 X-API-Key がありません
403 API キーが無効または失効しています
429 レート制限超過。Retry-After ヘッダを返します
404 公開対象の法人が見つかりません
curl -H "X-API-Key: $KEY" https://hojindb.jp/v1/corp/1180301018771
employees は公表従業員数（gBizINFO）。公表値が無い企業では insured_count（厚生年金被保険者数にもとづく推定従業員規模。公式の総従業員数ではなく、短時間労働者等の厚生年金適用外は含まれません）を返します。代表者氏名は含まれません（法人詳細 Web ページの閲覧表示のみ）。厚生年金被保険者数が5人未満の法人は insured_count を出さず insured_count_range: "1-4" を返します（個人の推知防止、日本年金機構データの利用条件。該当時、レスポンスJSONに insured_count キー自体が含まれません）。
/v1/corp
認証必須
商号・都道府県・業種で法人を検索
q、pref、industry の少なくとも一つを指定します。
| パラメータ | 場所 | 必須 | 説明 |
|---|---|---|---|
q |
query | 任意 | 商号・よみ・英語名の部分一致 |
pref |
query | 任意 | 都道府県名。例: 東京都 |
industry |
query | 任意 | 業種名または業種コードの部分一致。例: 製造 |
limit |
query | 任意 | 返却件数。既定20、最大100 |
offset |
query | 任意 | 先頭からのスキップ件数。既定0 |
200 成功
400 入力値が不正
401 X-API-Key がありません
403 API キーが無効または失効しています
429 レート制限超過。Retry-After ヘッダを返します
curl -H "X-API-Key: $KEY" "https://hojindb.jp/v1/corp?q=トヨタ&pref=愛知県"
人物名からの逆引き検索は非対応です。
/v1/openapi.json
認証不要
OpenAPI 仕様を取得
認証不要の機械可読 API 仕様です。
200 OpenAPI 3.0 仕様
curl https://hojindb.jp/v1/openapi.json
利用プラン
| プラン | 月額 | 日次上限 | 分次上限 |
|---|---|---|---|
| β版無償 | ¥0 | 100件/日 | 10件/分 |
ベータ期間中は全ユーザーが同一プランです。上限超過は 429 + Retry-After ヘッダーを返します。最新のプラン情報は 料金・プラン をご覧ください。
機械可読な完全仕様（OpenAPI 3.0）は /v1/openapi.json です。MCP 経由での利用は MCP 接続ガイド をご覧ください。