無料でAPIキー取得

学ぶ

EDINET解析ガイド:書類・タグ・階層から、使いたい財務データを探す

EDINETのXBRL解析は、目的の書類を選び、項目の意味と値の条件を確認する作業です。このページでは、有価証券報告書の一つの数値を調べるとき、どの情報をどの順番で見るかを整理します。

このページで分かること

  • check_circle会社と書類を識別し、値の期間・範囲・単位を確認します。
  • check_circle表の階層とタグの定義を分け、出典と版を残します。
  • check_circle主要項目・科目の階層・ファクトから必要な入口を選びます。

最初に、書類の種類と対象を決める

企業の概要を知りたい段階と、分析用のデータを取得したい段階では、読む場所が違います。書類、項目、期間、表の構造を分けると、必要な作業を絞れます。

EDINETには、有価証券報告書だけでなく、有価証券届出書や大量保有報告書などもあります。提出者の名前が目的の企業に似ているだけで選ばず、書類種別と対象を確認します。金融庁:EDINETについて

例えば、ある企業の事業と年次の財務を調べたいなら、有価証券報告書が入口の一つです。一方、その企業の株式を誰が大量に保有しているかという問いでは、見る書類と提出者の関係が違います。

自分の問い最初に確認するもの
どんな事業を営む会社か事業の説明、対象書類の種類
一年間の売上高はいくらか対象年度、連結・個別、損益の表
どの事業が収益を生むかセグメントの区分と指標の定義
給与や従業員数はどう変わったか提出会社かグループか、対象期間、単位

同じ書類の中でも、平均年間給与と連結従業員数の対象範囲が一致するとは限りません。「同じ報告書に載っている」ことと「同じ範囲で比較できる」ことを分けます。

書類を識別する番号と、会社の番号を分ける

会社を特定する情報だけでは、どの報告書を読んだかまでは決まりません。EDINET APIの一覧では docID が書類を識別する情報です。parentDocID などの関係情報や書類種別、訂正・取下げに関わる状態は、利用する仕様に沿って確認します。EDINET API仕様書

保存する情報後で答えたいこと
書類の識別情報どの書類から取得したか
提出者・対象誰の報告で、何を対象とするか
対象期間いつの業績か
提出日時・取得日時いつ公表され、いつ取得したか
関係情報と状態訂正や取下げの確認が必要か

訂正報告書を見つけても、その一つに分析に必要な全数値が再収録されているとは限りません。元の書類と訂正内容を確認し、変更が必要な範囲を判断します。タイトルの文字だけで全体を置き換える設計は避けます。

XBRLは「項目・値・条件」を組み合わせて読む

タクソノミは項目の定義や関係、インスタンスは今回報告された値などを表します。値の対象と期間はコンテキスト、単位はユニットを確認します。これらは同じファイルの別の場所に記されていることがあります。

売上高の数値と、期間・単位を結び付ける

NetSales / 323,609,000,000

  • contextRef → context

    2025-04-01 → 2026-03-31

    参照先の開始日・終了日を確認する

  • unitRef → unit

    JPY = 円

    参照先の measure を確認する

金融庁の2026年版公式サンプルを整理。実在企業の業績やAPI応答ではありません。

図は2026年版EDINETタクソノミの公式サンプルに含まれる一件を整理したものです。実在企業の業績やZENITH CodeのAPI応答を示す図ではありません。

部品確認する内容見落としやすいこと
要素名前空間と要素名接頭辞の文字だけで同じ項目と判断する
コンテキスト対象・期間・軸IDの名前から意味を決め付ける
ユニット通貨、株数、分子・分母円と円/株を同じものとして扱う
ファクト値、欠損、精度などnil や未取得をゼロへ変える

例えば同じ売上高タグが複数あっても、前年・当年、連結・個別、セグメント別なら用途が違います。検索結果の先頭や最大値を採用する方法では、必要な条件を保証できません。

表の階層は、数値の並びだけから作らない

XBRLファイル内で要素が出現する順番を、そのまま財務諸表の表示順と考えないようにします。表示リンクは、項目の親子関係や順序を調べる材料です。

表示リンクの loc は項目への参照、presentationArc は項目間の関係をたどる手がかりです。order で順序、preferredLabel で表示に使うラベルの役割を確認します。同じ項目が異なる表の役割で使われることもあるため、関係が属するロールも残します。提出者別タクソノミ作成ガイドライン

作りたい表示必要な確認
科目の順番を保った表表示ロール、親子関係、順序
期首・期末を区別する見出しラベルの役割、時点の条件
数値だけの比較表項目の意味、期間、範囲、単位

表示上の子項目が全て足し算できるとは限りません。見出しや控除項目、符号、集計範囲などがあるためです。「親子関係を表示できた」と「小計を再計算して一致した」は、別の確認として扱います。

タグは毎回調べるか、一覧へまとめるか

学習中の一件なら、元ファイルと公式定義を照合する方法で構いません。書類が増えたら、一度読んだ定義を再利用するキャッシュを考えます。キャッシュは、確認した内容を保存して、同じ定義を何度も読み直さない仕組みです。

ただし、見つけたタグを一つの名前だけで永続的に統合するのは避けます。タクソノミの版、名前空間、提出者別の定義、出典書類などを区別して残します。日本語ラベルが同じでも、必ず同じ意味とは限りません。

新しく見つかったもの保存の考え方
未知の要素元の名前空間と要素名、出典を残す
新しいラベル言語とラベルの役割を残す
似た名称の項目対応候補にする段階と、同義と確定する段階を分ける
タクソノミの更新版を区別し、既存の定義を無条件で上書きしない

公開されている定義を集める処理と、分析用の共通項目へ対応付ける判断は別です。未知のタグを見つけたら自動で既存項目へ吸収する、という一段階の処理にしないことが大切です。

ZENITH Codeでは、必要な粒度から入口を選ぶ

主要項目の推移を見たい場合と、一つの書類にあるタグを詳しく調べたい場合では、使うデータの形が違います。

目的APIの入口確認するもの
売上高・利益の比較損益計算書決算期、期間区分、会計基準、欠損
表の内訳・階層財務諸表の全科目深さ、親、順序、元のタグ、値の条件
有価証券報告書の要素別の値XBRL数値データ書類、コンテキスト、次元メンバー、取得上限

APIで構造化されていても、用途に合う値かどうかの確認は残ります。例えば要素名を部分一致で検索した結果には、前年や別の範囲の候補が含まれる可能性があります。検索条件の一致だけで比較用の一行が完成するわけではありません。

最初は一社・一期・一項目を選び、応答の値と条件を確認します。その後、目的が推移なら年度を増やし、内訳なら同じ期間の範囲を広げます。一度に会社も年度も項目も増やさない方が、どの条件で結果が変わったかを確認しやすくなります。

次に読む

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

よくある質問

投資家・開発者向け

有価証券報告書に載っている表は、全部一つの数値として取得できますか?
その前提では扱いません。文章や表をまとまりで扱う部分もあり、個別の数値としてタグ付けされた情報とは区別します。欲しい項目が、どの形式・粒度で収録されているかを確認してください。
まずどの資料で練習すればよいですか?
金融庁の2026年版公式サンプルを使えば、対象を固定して同じ値と参照先を確認できます。サンプルの数値は実在企業の業績として扱わず、版と対象ファイルを記録します。

AI・研究者向け

AIが同じ日本語ラベルと判断したら、項目を統合できますか?
名称の類似だけで統合は決められません。定義、型、対象期間、範囲、名前空間などを確認し、判断の根拠を残します。候補の提示と、データとしての採用を分けると誤りを追いやすくなります。
gavel

免責事項

この記事は、データの仕組みと API の使い方を説明するものです。特定の銘柄の売買を勧めるものではなく、投資助言ではありません。実例の数値は記事の作成時点の応答で、その後の開示や訂正で変わることがあります。投資の判断はご自身の責任で行ってください。