IR Sections

IR PDF セクション検索 (プレビュー)

IR PDF (決算説明資料・中期経営計画・統合報告書・コーポレートガバナンス報告書・サステナビリティレポート) の 構造化セクション (body + heading + section_type + theme_tags + industry_tags) を検索。

重要: このエンドポイントはプレビュー機能で、有効化された環境でのみ動作します。 本番公開前は 404 を返します (内部テスト用)。

body は AI が生成した定性要約であり、定量数値 (売上・利益・EPS 等) が含まれる場合があります。 この数値は当社の財務フィールド検証を通っていないため、原典 PDF または XBRL 由来の年次財務データで必ず確認してください。 body は定性情報 (戦略・目標・施策・背景) 中心です。

get/ir/sections/search

Request

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

Query parameters

qstring

body/heading への部分一致 (case-insensitive、連続フレーズ)。

queriesstring[]

複数キーワードの AND/OR 検索 (掛け算検索)。各語が body/heading に部分一致し queries_match で結合。repeatable または CSV (例 ?queries=SaaS&queries=M%26A&queries=買収)。最大 10 語×各 200 字。q (連続フレーズ) と併用可。

queries_match'and' | 'or'

queries の結合方法。and (デフォルト)=全語を含む / or=いずれか1つ以上。

section_typestring

cover/summary/financial/business_segment/strategy/market/guidance/statement/governance/esg/qa/appendix/other のいずれか。

pdf_typestring

decks/integrated/midterm/governance/internal_control/sustainability/forecast/tanshin/securities_report/quarterly_report/shareholder_meeting/fact_book/corporate_action/press_release/other のいずれか (v0.3 タクソノミ)。internal_control は 2026-08 に governance から分離した 内部統制報告書。

edinet_codestring[]

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

industrystring

業種名 (完全一致)。

theme_tagstring

単一 theme_tag で絞込 (例 biz:dx_ai, esg:ghg_reduction, mkt:segment_entry)。

theme_tagsstring[]

複数 theme_tags で串刺し絞込。repeatable または CSV (例 ?theme_tags=mkt:segment_entry,mkt:premium_shift)。match で AND/OR を指定。

match'any' | 'all'

theme_tags の結合方法。any (OR、デフォルト)=いずれか1つ以上を持つ / all (AND)=全部を持つ。

exclude_tagsstring[]

これらの theme_tag を持つセクションを除外 (repeatable または CSV)。

industry_tagstring

industry_tag で絞込 (例 ind:electric:power_grid_service, ind:pharma:pipeline)。

sincestring date

PDF 発見日 >= 指定日 (YYYY-MM-DD)。

semanticboolean

多言語の埋め込みモデルによる意味検索。semantic=true で有効化 (q 必須)。COSINE 距離で top_k 取得。埋め込み生成に失敗した場合はキーワード (LIKE) 検索に切替え、meta.search_mode_degraded=true を返す (silent fallback しない)。

include_reviewboolean

確認済みの本文品質問題 (捏造・空抽出・非接地生成) と判定されたセクション (約8,000件・実測2026-07-12、大半は本文が空) は既定で除外される。true 指定でそれらも含め、レスポンス行に needs_review / review_reason フィールドを開示する。

include_summaryboolean

true で要約行 (body_kind=summary) の summary に本文を入れる (現在は body と同文)。既定 false = summary は常に null。body_kind / summary_meta は常に返る。受理値 = true/1/yes → true、false/0/no → false (大文字小文字・前後空白は無視)、未指定・空値 = false、それ以外は 400。

limitinteger

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

Response

セクション一覧。ヒット社の coverage 集計を meta.coverage_summary に併記 (2026-05-26 追加、silent skip 防止)。

coverage_summary object:

  • matched_companies: ヒットした企業数 (sections の DISTINCT edinet_code)
  • companies_with_unparseable_only: 全 PDF が unparseable で sections=0 になっている社の数
  • companies_with_partial_unparseable: 一部 PDF が unparseable な社の数
  • warning: 1 件以上あれば人間可読の説明文字列
  • docs_url: /docs/methodology#parse-failure-categories

個社の詳細は /v1/companies/{code}/ir/sections で meta.coverage を参照。

semantic=true 指定時の degraded fallback (2026-07-11 追加): embedding 生成に失敗した場合、キーワード (LIKE) 検索の結果を返しつつ meta.search_mode_degraded=true と meta.degraded_reason (固定値 semantic_unavailable_fallback_keyword) を付与する。以前は WARNING ログのみで 呼び出し側に区別する手段がなかった (silent fallback)。この応答は キャッシュされない (Cache-Control: no-store)。

Example response

{
  "data": [
    {
      "body_kind": "summary",
      "parser": "tanshin-regex",
      "parser_family": "regex",
      "summary_meta": {
        "parser": "deepseek-flash-l2",
        "processed_at": "2026-08-07T01:02:03Z",
        "verification_targets": {
          "edinet_code": "E02144",
          "mcp_tools": [
            "get_earnings",
            "get_financials"
          ],
          "rest_paths": [
            "/v1/companies/E02144/earnings",
            "/v1/companies/E02144/financials"
          ]
        }
      }
    }
  ]
}

Changes

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