IR KPIs

IR KPI 検索 (プレビュー)

中期経営計画 (midterm) + 統合報告書 (integrated) のセクションから抽出した数値KPI を横断検索。 経営目標・業績予想・投資計画・株主還元方針・人的資本KPI・ESG目標 など、定量的な目標値を kpi_category × period_year_target × value_numeric の組合せで絞り込める。

各 KPI には value_numeric + unit + period_year_target + source_quote が付く。 PDF への直接ダウンロードリンクは含まれない。元書類の特定には edinet_code + pdf_type + pdf_title + page_start/page_end を使う。企業の IR PDF 一覧の閲覧・ダウンロードは /v1/ir/documents + /v1/ir/documents/{doc_id}/pdf-url を別途利用する。

重要: プレビュー機能。プレビューが有効な環境でのみ動作。

抽出ルール:

  • 単年実績数値 (前期売上・OI・EPS) は対象外 (XBRL から取得済 → /v1/companies/{code}/financials)
  • 中長期目標値・投資コミット・事業構成事実・非財務 KPI のみが対象
  • value_numeric は unit に書かれた単位のままの値 (例: 「5,400億円」→ 5400.0, unit="億円")。 下流の正規化はクライアント側で行う
get/ir/kpis/search

Request

  • Base URL: https://edinetdb.jp/v1
  • URL: https://edinetdb.jp/v1/ir/kpis/search
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

qstring

kpi_name または source_quote への部分一致 (case-insensitive)。

kpi_category'financial' | 'non_financial' | 'segment' | 'investment' | 'shareholder_return' | 'esg' | 'hr' | 'strategy' | 'other'

KPI カテゴリ。

metric_subtype'target' | 'forecast' | 'plan' | 'baseline' | 'historical_fact'

数値の種別。target=中長期目標、forecast=業績予想、plan=投資コミット、baseline=基準値、historical_fact=現在/過去のスナップショット。

pdf_type'midterm' | 'integrated'

抽出元 PDF 種別。

edinet_codestring[]

企業コードで絞込 (複数指定可、最大 50)。

industrystring

業種名 (完全一致)。

period_year_targetinteger

目標年 (例 2030)。

period_year_mininteger
period_year_maxinteger
unitstring

単位フィルタ (例 "億円", "%", "tCO2", "人")。

currencystring

JPY / USD / 等。

min_valuenumber float
max_valuenumber float
include_reviewboolean

needs_review=true (LLM 自己レビューフラグ、低 confidence) の行も含める。

include_priority_highboolean

XBRL クロス検証で誤抽出と判定された KPI (priority='high'、UT 型市場統計の自社誤抽出・ 桁違い・子会社情報引用 等、全 KPI の約 1%) も含める。include_review とは独立。 デバッグ・パワーユーザ用。

limitinteger

最大件数 (default 20, max 50)。

Response

KPI 一覧。レスポンスフィールドには XBRL 検証結果を含む: validation_status (verified / unverifiable / flagged_*), needs_review_priority (high / medium / low / null), validation_detail (JSON: 比較値・乖離率等), validated_at (ISO 8601)。 priority=medium の KPI は「⚠️ 実績との乖離大」注記付きで表示推奨。

Changes

No recorded changes to this operation across all 1 revision of this API.