gBizINFO REST API ガイド

概要

経済産業省・デジタル庁が提供するgBizINFO（法人活動情報）のREST APIを使用して、約400万法人の企業情報を検索・取得する。

v2移行情報: 2026年1月26日にv2 APIが稼働開始。v1 APIは2026年9月に廃止予定。 新ポータル: https://content.info.gbiz.go.jp/api/index.html v1→v2変更点: https://info.gbiz.go.jp/html/v1->v2変更点一覧.pdf

認証

APIトークンを全リクエストのヘッダーに含める。

トークン取得手順

1. https://info.gbiz.go.jp/hojin/api_registration/form にアクセス
2. 利用目的・連絡先等を入力して申請
3. メールでAPIトークンが発行される（無料）

環境変数に設定（推奨）

export GBIZINFO_TOKEN="your_token_here"

核心ルール

1. 検索には name または corporate_number のいずれか1つが必須
2. 法人番号は13桁の数字（国税庁法人番号公表サイトで確認可能）
3. JSONキーにハイフン含み: hojin-infos → ブラケット記法 data["hojin-infos"] 必須
4. ページネーション上限: page 最大10、limit 最大5000（最大50,000件）
5. レート制限: 10分間に約6,000リクエスト、超過で10分間ブロック
6. v2移行推奨: v1は2026年9月廃止予定。新規開発はv2を使用
7. 中小企業の財務情報: 未登録の場合があるため null チェック必須
8. トークン管理: 環境変数 $GBIZINFO_TOKEN で管理、ハードコード禁止
9. 500エラー: 認証エラーが500で返る場合あり（Swagger定義と異なる）
10. 型に注意: 数値系パラメータも多くがString型としてOpenAPI上定義

主要エンドポイント（概要）

クイックスタート

法人名で検索

curl -s "https://api.info.gbiz.go.jp/hojin/v1/hojin?name=トヨタ&page=1&limit=10" \
  -H "Accept: application/json" \
  -H "X-hojinInfo-api-token: $GBIZINFO_TOKEN"

法人番号で基本情報を取得

curl -s "https://api.info.gbiz.go.jp/hojin/v1/hojin/1010401089234" \
  -H "Accept: application/json" \
  -H "X-hojinInfo-api-token: $GBIZINFO_TOKEN"

特定法人の補助金情報

curl -s "https://api.info.gbiz.go.jp/hojin/v1/hojin/1010401089234/subsidy" \
  -H "Accept: application/json" \
  -H "X-hojinInfo-api-token: $GBIZINFO_TOKEN"

東京都の株式会社を検索（資本金1億円以上）

curl -s "https://api.info.gbiz.go.jp/hojin/v1/hojin?name=テクノロジー&corporate_type=301&prefecture=13&capital_stock_from=100000000&page=1&limit=20" \
  -H "Accept: application/json" \
  -H "X-hojinInfo-api-token: $GBIZINFO_TOKEN"

詳細リファレンス

references/api-reference.md

• エンドポイント一覧（v1/v2全件）
• 検索パラメータ全35項目
• 期間指定パラメータ
• レスポンス構造（HojinInfoResponse、エラー形式）
• 基本情報フィールド一覧（HojinInfo）
• ページネーション詳細
• v1/v2 対応表・v2追加パラメータ
• レート制限・エラーハンドリング

references/code-tables.md

• 法人種別コード（corporate_type: 101〜499）
• 都道府県コード（JIS X 0401: 01〜47）
• コード区分一覧（平均年齢、勤務年数、残業時間、女性割合）
• 出典元コード（source: 1〜6）
• 外部コードリスト（PDF）へのリンク

references/search-patterns.md

• 基本コマンド集（名前検索、番号取得、並列取得）
• よく使う検索パターン（財務フィルタ、大株主、補助金・特許）
• 取引先調査パターン（補助金実績、財務状況、認定・資格、特許）
• jqでの整形・抽出（一覧、ソート、CSV出力）
• Usacon統合パターン（顧問先情報収集、Jグランツ連携）
• チェックリスト（API呼び出し前 / レスポンス処理）
• トラブルシューティング（500エラー、0件、ページネーション、レート制限）

注意事項

1. トークン管理: APIトークンは環境変数で管理し、コードにハードコードしない
2. ハイフン付きキー: JSONレスポンスのhojin-infosはハイフン含み。ブラケット記法必須
3. データ網羅性: 全法人の全データが揃っているわけではない。特に中小企業は財務情報が未登録の場合がある
4. v2移行: v1は2026年9月廃止予定。新規開発はv2を推奨
5. page上限: 検索のpageは最大10。それ以上の結果は検索条件を絞り込んで対応
6. 型に注意: 数値系パラメータも多くがString型（数字パターン）としてOpenAPI上定義されている

関連スキル

• jgrants -- 補助金検索API（企業の補助金受給状況）。gBizINFOで取得した企業情報と、Jグランツの受付中補助金情報を組み合わせてコンサルティングに活用
• usacon -- 企業調査データのコンサルティング活用。DXコンサルティングにおける顧客企業の財務・認定・補助金情報の分析に利用
• mba-strategy-consultant -- 経営戦略フレームワーク。企業の財務データやポジショニング分析にgBizINFO情報を活用

関連リソース

• gBizINFO ポータル
• API利用ガイド
• Swagger UI
• 新ポータル（v2）
• APIポリシー（PDF）
• コードリスト（PDF）
• 担当府省コードリスト（PDF）
• METI gBizINFO概要
• 国税庁法人番号公表サイト
• Jグランツ API（補助金検索） - 補助金の検索はJグランツが適切

改訂履歴