財務データAPIの選び方：主要項目・財務諸表の階層・XBRLファクトを使い分ける

このページでは、三つの入口の違いと、一つの取得例で確認する項目を説明します。構造化されたデータを使う場合にも、対象期間・範囲・欠損の確認は必要です。

「取れるデータを全部取ってから考える」よりも、表示したい一行を先に書くと、必要なAPIを選びやすくなります。

図：機能の優劣を表す段階図ではありません。必要な結果に合わせて選ぶための案内です。

売上高や営業利益などを年度ごとに比較したい場合は、損益計算書APIが入口です。revenue、operatingIncome などの主要項目を使います。

最初は年次のデータを取得し、応答の fiscalPeriod、period、accountingStandard を確認します。配列の先頭が自分の意図する年度だと決めず、画面に出す順番を明示的に揃えます。

同じ項目名で並べられても、会社や年度の条件が同じとは限りません。標準化された項目を使うことと、比較の妥当性を判断することは別です。

表の見出しや科目の内訳を表示したい場合は、財務諸表の全科目APIを確認します。depth、parent_key、sort などが、階層や順序を扱う手がかりです。

例えば「資産」の下に「流動資産」、その下に個々の科目を表示したい場面では、金額だけの配列では親子関係が分かりません。親と順序を保持してから、表示の字下げなどを決めます。

表示の階層は、そのまま足し算の式を表すとは限りません。親の数値と子の合計を比較するなら、符号や集計範囲、見出し行なども確認します。

通期を指定する引数は、このAPIでは quarter=FY です。損益計算書の period=annual をそのままコピーしないようにします。似た用途でも引数名や形式はエンドポイントごとに確認してください。

有価証券報告書のXBRL数値データAPIは、要素とコンテキストごとの値を調べる入口です。分類を指定する category や、要素名の部分一致で絞る tag を使えます。

ファクトは、ここでは報告された一つの値などを指します。同じ要素でも、期間や範囲が違えば別の候補になります。取得した行を、会社全体の現在の値として無条件に採用しないようにします。

最初の問い合わせを小さくする

次の例は、トヨタ自動車（7203）の2026年3月期について、貸借対照表の分類から最大20件を取得するリクエストです。20件で全ての項目を取得できる、という指定ではありません。

実際に利用する際は登録・APIキーが必要です。下の YOUR_API_KEY は自分のキーに置き換えます。キーを記事や公開リポジトリへ貼り付けないでください。問い合わせは利用枠を消費するため、現行のプラン・利用量はドキュメントと管理画面で確認します。

curl --fail-with-body --get \
  'https://api.zenithcode.net/stable/financial-facts' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data-urlencode 'symbol=7203' \
  --data-urlencode 'fiscalPeriod=2026-03' \
  --data-urlencode 'category=Balance_Sheet' \
  --data-urlencode 'limit=20'

Pythonは標準ライブラリでリクエストできます。ここでは、応答の書類情報と取得件数だけを表示します。コード自体が、各行の条件を解釈して正しい数値を選ぶわけではありません。

import json
from urllib.parse import urlencode
from urllib.request import Request, urlopen

query = urlencode({
    "symbol": "7203", "fiscalPeriod": "2026-03",
    "category": "Balance_Sheet", "limit": "20",
})
request = Request(
    "https://api.zenithcode.net/stable/financial-facts?" + query,
    headers={"x-api-key": "YOUR_API_KEY"},
)
with urlopen(request, timeout=30) as response:
    reports = json.load(response)
for report in reports:
    print(report["symbol"], report["fiscalPeriod"], report["docId"])
    print("取得件数:", len(report["facts"]))
    print("上限による打ち切り:", report["truncated"])

JavaScriptは、fetch が使えるNode.jsで実行する例です。ブラウザで一般公開する画面のコードへ、秘密のAPIキーを埋め込まないようにします。

const query = new URLSearchParams({
  symbol: '7203', fiscalPeriod: '2026-03',
  category: 'Balance_Sheet', limit: '20',
});
const response = await fetch(
  `https://api.zenithcode.net/stable/financial-facts?${query}`,
  { headers: { 'x-api-key': 'YOUR_API_KEY' } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const reports = await response.json();
for (const report of reports) {
  console.log(report.symbol, report.fiscalPeriod, report.docId);
  console.log('取得件数:', report.facts.length);
  console.log('上限による打ち切り:', report.truncated);
}

truncatedを確認してから「全部取れた」と判断する

truncated=true は、件数上限で結果が打ち切られたことを表します。取得できた20件だけを見て、必要な科目が存在しないと判断しないようにします。

分類やタグの条件を狭めるか、仕様で許される範囲で上限を調整します。tag は要素名の部分一致なので、条件を絞った後も、返ったタグとコンテキストを確認します。複数の問い合わせに同じ行が含まれる可能性もあるため、単純に結果を足し合わせて全件取得と見なさないようにします。

truncated=false でも、元の報告書の全情報を取得したことを意味しません。指定した条件とAPIの提供範囲の中で、上限による打ち切りがないことを確認する情報です。

値だけを保存すると、後から比較条件を調べにくくなります。少なくとも、会社、書類、項目、期間、範囲、単位、取得日時を確認できる形にします。

例えばグラフへ渡すときは、横軸の年度、縦軸の単位、実績と予想の区別、欠損の扱いを決めます。元データの期間を捨てて年度ラベルだけにすると、同じラベルの年間と半年累計を混ぜてしまう可能性があります。

自分で条件を選び、表やグラフを作りたい場合はZENITH Codeが入口です。完成した企業分析画面を使いたい場合は、同じCrabgrassが運営するStockClubという選択肢もあります。ZENITH Codeにも整理済みのデータがあるため、「未解析データと解析済みデータ」という区別ではありません。

• TDnet解析ガイド
• EDINET解析ガイド

• 損益計算書API
• 財務諸表の全科目API
• XBRL数値データAPI
• 累計と四半期単独の違い
• 過去時点の情報を扱う考え方

私たち株式会社Crabgrassは、財務データAPI「ZENITH Code」を開発・提供しています。本記事は技術解説であり、特定の金融商品の売買を勧めるものではありません。