API ドキュメント
IRDB の REST API は APIキー無しでも無料で利用できます。 全エンドポイントは JSON を返します。APIキー無しの場合は1IPあたり 60req/分のIPベース制限が適用されます。APIキーを発行すると、 ご自身の利用状況（日次リクエスト数）を確認できます。
基本情報
- ベースURL
- https://houjin.goo.to/irdb
- バージョン
- v1
- 認証
- 任意（
X-API-Keyヘッダ、またはAuthorization: Bearer <key>） - レスポンス
- application/json; charset=utf-8
- エンコード
- UTF-8
- CORS
- 許可 (Access-Control-Allow-Origin: *)
APIキーについて
/account/api-keys から Googleアカウントでログインの上、無料でAPIキーを発行できます（1アカウントあたり最大5個）。
APIキーを付与したリクエストには、応答ヘッダに以下が付与されます。
X-RateLimit-Limit: 日次リクエスト上限（Freeプラン: 500回/日、JST基準）X-RateLimit-Remaining: 本日の残りリクエスト数
上限に達すると 429 Too Many Requests が返ります。
エンドポイント
GET
/api/v1/companies企業一覧を取得（ページング可、検索/業種フィルタ対応）
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| page | number | ページ番号（デフォルト1） | |
| limit | number | 1ページ件数（最大100、デフォルト50） | |
| q | string | 企業名・証券コードでの検索 | |
| industry | string | 業種コード（例: 3650 = 電気機器） |
サンプル
/api/v1/companies?industry=3650&limit=10
GET
/api/v1/companies/{edinetCode}個別企業の最新財務データと健全性スコアを取得
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| edinetCode | string | ✓ | EDINETコード（例: E02552） |
サンプル
/api/v1/companies/E02552
GET
/api/v1/rankings指標別ランキング上位N社を取得
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| metric | string | ✓ | 指標キー（roe / roa / roic / operating-margin / net-margin / equity-ratio / current-ratio / revenue / net-income / free-cash-flow / dividend-payout の11種類） |
| limit | number | 取得件数（最大100、デフォルト100） | |
| industry | string | 業種コードフィルタ |
サンプル
/api/v1/rankings?metric=roe&limit=20
GET
/api/v1/industries東証33業種分類と各業種の所属企業数
サンプル
/api/v1/industries
GET
/api/v1/search企業横断のキーワード検索（インクリメンタル検索用）
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| q | string | ✓ | 検索クエリ（企業名・証券コード・EDINETコードに対する部分一致） |
サンプル
/api/v1/search?q=トヨタ
GET
/api/v1/screening複数指標の AND 条件で企業を絞り込み（最大500社）
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| conditions[i][metric] | string | ✓ | 指標キー（i=0,1,2...で複数条件を指定、最大10件） |
| conditions[i][operator] | string | ✓ | 'gte'（以上）または 'lte'（以下） |
| conditions[i][value] | number | ✓ | しきい値 |
| industry | string | 業種コードフィルタ |
サンプル
/api/v1/screening?conditions[0][metric]=roe&conditions[0][operator]=gte&conditions[0][value]=15
利用上の注意
• データは金融庁EDINETの有価証券報告書を基に IRDB が抽出・算出したものです。投資判断には一次情報をご確認ください。
• ライセンスは CC BY 4.0。出典として https://houjin.goo.to/irdb を明示してください。
• 高頻度・大量取得時は1IPあたり60req/分を目安に。明らかなクロール濫用は遮断対象になります。
• APIは予告なく仕様変更する可能性があります。本番システムに組み込む場合は最新の本ページを参照してください。