API ドキュメント
IRDB の REST API は 認証不要・無料で利用できます。 全エンドポイントは JSON を返します。レート制限は 1IPあたり 60req/分 目安です。
基本情報
- ベースURL
- https://houjin.goo.to/irdb
- バージョン
- v1
- 認証
- 不要
- レスポンス
- application/json; charset=utf-8
- エンコード
- UTF-8
- CORS
- 許可 (Access-Control-Allow-Origin: *)
エンドポイント
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}個別企業の詳細データ（最新財務 + 過去最大6年分 + ESG + 大株主）
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| edinetCode | string | ✓ | EDINETコード（例: E02552） |
サンプル
/api/v1/companies/E02552
GET
/api/v1/rankings指標別ランキング上位N社を取得
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| metric | string | ✓ | 指標キー（roe / pbr / health-score 等、全25種類） |
| limit | number | 取得件数（最大100、デフォルト20） |
サンプル
/api/v1/rankings?metric=roe&limit=20
GET
/api/v1/industries東証33業種分類と各業種の所属企業数・業種平均
サンプル
/api/v1/industries
GET
/api/v1/search企業横断のキーワード検索（インクリメンタル検索用）
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| q | string | ✓ | 検索クエリ（企業名・証券コードに対する前方一致＋部分一致） |
サンプル
/api/v1/search?q=トヨタ
POST
/api/v1/screening複数指標の AND 条件で企業を絞り込み
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| conditions | array | ✓ | 条件配列。各要素 {metric, operator: 'gte'|'lte', value} |
| industry | string | 業種コードフィルタ | |
| limit | number | 結果件数（最大200、デフォルト50） |
サンプル
POST /api/v1/screening
{
"conditions": [
{"metric": "roe", "operator": "gte", "value": 15},
{"metric": "equityRatio", "operator": "gte", "value": 50}
],
"industry": "3650"
}利用上の注意
• データは金融庁EDINETの有価証券報告書を基に IRDB が抽出・算出したものです。投資判断には一次情報をご確認ください。
• ライセンスは CC BY 4.0。出典として https://houjin.goo.to/irdb を明示してください。
• 高頻度・大量取得時は1IPあたり60req/分を目安に。明らかなクロール濫用は遮断対象になります。
• APIは予告なく仕様変更する可能性があります。本番システムに組み込む場合は最新の本ページを参照してください。