無料API
無料API
EDINET開示データを取得できる無料・非商用のREST / GraphQL / MCP APIをご案内します。
EDINET(金融庁の開示システム)へ提出された開示書類から作成した、企業の基本情報・財務指標の時系列・セグメント情報・ランキングなどを取得できる読み取り専用APIです。
- 利用条件
- 無料でご利用いただけます。ただし非商用利用に限ります(商用利用不可)。
- 出典
- EDINET(金融庁)のデータを加工して作成しています。
- データの扱い
- データは無保証です。投資判断は、必ず原典(EDINETの開示書類)をご確認のうえ行ってください。
- 更新頻度
- 毎日更新されます。
meta.dataUpdatedAtが現在のデータの更新時刻(UTC)です。 - キャッシュ
- 200応答にはETagが付きます。内容が変わらない限り同じ値を返すため、キャッシュに活用できます。
- CORS
- すべてのオリジンからの読み取りを許可しています。GET / HEADのみ受け付けます。
- 認証
- 不要です。APIキーの登録なしにそのまま呼び出せます。
エンドポイントの詳細は、本ページのエンドポイント一覧をご参照ください。
# 1. 企業を探す(企業名・証券コード・EDINETコードで検索できます)
curl -G "https://api.yuhodb.com/v1/edinet/companies" --data-urlencode "q=トヨタ"
# 2. 売上高の時系列を取得する(証券コードのままで指定できます)
curl "https://api.yuhodb.com/v1/edinet/companies/7203/metrics?metric=revenue"
# 3. ROEランキング(2025年度・上位10社)
curl "https://api.yuhodb.com/v1/edinet/metrics/roe/ranking?year=2025&limit=10"日本語の検索語(q=トヨタ など)も指定できます。ただしURL上ではエンコードが必要なため、curlからは上の例のように -G と --data-urlencode を組み合わせるか、?q=%E3%83%88%E3%83%A8%E3%82%BF のようにパーセントエンコードして送ってください。ブラウザやHTTPクライアントライブラリからは、エンコードは自動で行われます。
等幅テキストで受け取る(format=text)
一覧系エンドポイント(企業検索・指標時系列・セグメント・ランキング・分布)は format=text を付けると等幅テキストの表(text/plain)で返ります。表は英語・ASCIIベース(金額は百万円単位)で、どの環境でも桁が揃います。curlの結果をそのまま読む用途に便利です。省略時はJSONです。
curl "https://api.yuhodb.com/v1/edinet/companies/7203/metrics?metric=revenue,operating_income,roe&format=text"
トヨタ自動車株式会社 (E02144 / 72030) Industry: 輸送用機器
Fiscal years: default latest 5, use from/to to extend. * = non-consolidated
[Income Statement] (JPY millions)
+----------------------------------+-----------------+-----------------+-----------------+
| Item | 2024 | 2025 | 2026 |
+----------------------------------+-----------------+-----------------+-----------------+
| revenue | 45,095,325 | 48,036,704 | 50,684,952 |
| operating_income | 5,352,934 | 4,795,586 | 3,766,216 |
+----------------------------------+-----------------+-----------------+-----------------+| メソッド | パス | 概要 | 主なパラメータ |
|---|---|---|---|
| GET | /companies | 企業検索・一覧。企業名の部分一致、証券コード・EDINETコードの完全一致で検索します。qを省略すると全企業の一覧になります。 | q / limit(既定50・最大1,000)/ offset / format |
| GET | /companies/{code} | 企業プロフィール。基本情報と、書類種別ごとの収録件数・収録年度範囲を返します。 | — |
| GET | /companies/{code}/documents | 財務報告書類の一覧(提出日の新しい順)。訂正報告書かどうか、原本の書類IDも含みます。 | type(120/130/140/150/160/170・カンマ区切り)/ from / to |
| GET | /companies/{code}/metrics | 財務指標の年次時系列。訂正報告書の内容は反映済みです。metricを省略すると、その企業が持つ全指標を返します。 | metric(カンマ区切り)/ from(既定は直近5年度)/ to / format |
| GET | /companies/{code}/segments | 最新年度の事業セグメント別指標(売上・利益・資産など)。過去年度の指定には対応していません。 | format |
| GET | /metrics | 指標キー一覧。各キーがどの開示項目(XBRL要素)に対応するかの定義を返します。 | — |
| GET | /metrics/{key}/ranking | 指標×年度の全社ランキング(最大1,000位まで)。母集団の内訳(値が確定した社数など)も返します。 | year(必須)/ limit(既定100・最大1,000)/ industry / format |
| GET | /metrics/{key}/distribution | 指標×年度の分布。全体・業種別のパーセンタイル(min / q10 / q25 / median / q75 / q90 / max)です。 | year(必須)/ format |
| POST | /graphql | GraphQLクエリの実行。RESTと同じデータを1リクエストでまとめて取得できます。GETでの実行にも対応しています。 | body: query / variables |
| POST | /mcp | MCPエンドポイント(JSON-RPC 2.0・Streamable HTTP)。AIアシスタントからの利用に使います。 | JSON-RPCメッセージ |
/graphql と /mcp の詳しい使い方は、GraphQL・MCP の各ページをご覧ください。
企業コード {code} の受け付け形式
- EDINETコード:
E02144(Exxxxx形式) - 証券コード:
7203/72030(4桁の場合は末尾に0を補い、5桁のコードとして扱います)
書類種別コード(documents の type)
この API が扱うのは、指標データの出典となる財務報告書類です。指定できるコードは次の6種類です。
120有価証券報告書130訂正有価証券報告書140四半期報告書(2024年度以降は制度廃止により減少)150訂正四半期報告書160半期報告書170訂正半期報告書
指標キー(metric)
時系列・ランキング・分布に指定する指標キーは revenue・operating_income・ordinary_income・net_income・total_assets・net_assets・roe・eps_basic・dps・employees など全58種類です。キーの全一覧と、各キーが対応する開示項目(XBRL要素)の定義は GET /metrics で確認できます。セグメント情報の側では seg_revenue・seg_operating_income などの seg_* キーを使います。
値の性質
指標値は開示書類から一定のルールで導出したもので、推測で埋めることはありません。開示が無い年度や、候補が複数あり一意に確定できない年度は value が null になります。連結の値を優先し、連結がない年度は非連結の値で補います(consolidated で判別できます)。訂正報告書がある場合は訂正後の値を返します(出典書類は docId で確認できます)。
fiscalYear は書類の提出年ではなく会計年度です。決算期を変更した年度には、同じ年度に12か月決算と移行期の短縮決算の2行が並ぶことがあります(periodMonths で判別できます)。また、セグメント値の合計は会社全体の値と一致するとは限りません(調整額・非開示セグメントがあるためです)。
すべてのレスポンスは、成功時は ok / data / meta、失敗時は ok / error の形式で返ります。
# GET /companies?q=トヨタ自動車
{
"ok": true,
"data": {
"query": "トヨタ自動車",
"total": 1,
"count": 1,
"offset": 0,
"companies": [
{
"edinetCode": "E02144",
"securitiesCode": "72030",
"companyName": "トヨタ自動車株式会社",
"companyNameEn": null,
"industry": "輸送用機器",
"docCount": 193,
"minFiscalYear": 2010,
"maxFiscalYear": 2026,
"lastSubmit": "2026-07-29"
}
]
},
"meta": { "apiVersion": "v1", "dataUpdatedAt": "2026-07-30T14:30:02Z" }
}# GET /companies/E99999 → 404
{
"ok": false,
"error": {
"code": "NOT_FOUND",
"message": "データが見つかりません。",
"details": { "code": "E99999" }
}
}定義外のクエリパラメータは400エラーになります(黙って無視しません)。details.allowed に、そのエンドポイントで使えるパラメータの一覧が入ります。
主なエラーコード
| コード | HTTP | 意味 |
|---|---|---|
INVALID_CODE | 400 | 企業コードの形式が不正です。 |
INVALID_PARAMETER | 400 | パラメータの形式が不正です。定義外のクエリパラメータもこのコードになります。 |
MISSING_PARAMETER | 400 | 必須パラメータがありません。 |
INVALID_METRIC | 400 | 指標キーの形式が不正です。 |
NOT_FOUND | 404 | 企業・データが見つかりません。 |
NO_DATA | 404 | 指定した指標のデータがその企業にありません。 |
METHOD_NOT_ALLOWED | 405 | GET / HEAD以外のメソッドです。 |
- 無料でご利用いただけますが、非商用利用に限ります(商用利用不可)。
- 出典はEDINET(金融庁)です。同システムのデータを加工して作成しています。
- データは無保証です。正確性・完全性を保証するものではありません。
- 投資判断は、必ず原典(EDINETの開示書類)をご確認のうえ、ご自身の判断で行ってください。本APIは投資勧誘を目的としたものではありません。
本サイトの運営情報・免責事項はサイトについてをご覧ください。