Screener

複数条件スクリーニング + preset themed screening

146指標で企業を絞り込み(2026-07-24 に CCC 系4指標 + 連続増配年数の5指標を追加)。 conditions JSON または shorthand クエリパラメータ(roe_gte=10&revenue_cagr_3y_gte=5)で指定可能。 重要: conditions(または roe_gte=10 等の shorthand)が最低1つ必須です。sort / order はソート順の指定にのみ使うパラメータで、絞り込み条件ではありません。preset を指定しない状態で sort / order のみを渡すと 400 No screening conditions provided を返します。指標でランキングだけしたい場合は /v1/rankings/{metric} を使うか、roe_gte=-999 のように実質無条件の conditions を1つ追加してください。 2026-05-23 追加: preset param で themed screening。 ?preset=ma_targets&industry=情報・通信業 で M&A 候補スクリーナー (低 PBR + 低 D/E + 安定 FCF)。 preset 指定時は conditions/sort 系は無視され、preset 固有の filter / score を使う。

get/screener

Request

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

Query parameters

preset'ma_targets'

2026-05-23 追加: themed screener preset。例 ?preset=ma_targets&industry=情報・通信業。 preset 指定時は conditions/sort 系は無視される。利用可能 preset: ma_targets (M&A 候補、industry param 必須、/queries/ma-targets から移管)。

conditionsstring

JSON 配列形式の条件。例: [{"metric":"roe","operator":"gte","value":10}]。 roe_gte=10 のような shorthand クエリパラメータでも指定可(conditions パラメータ自体は不要)。 preset を使わない場合、conditions または shorthand のいずれかを最低1つ指定してください(未指定は400)。 operator は gte / lte / gt / lt / eq。

industrystring

業種(日本語名)

standard'JP' | 'IFRS' | 'US'

会計基準

market'prime' | 'standard' | 'growth'

上場市場区分でフィルタ(プライム / スタンダード / グロース)。出典は有報の発行体記載(EDINET 公式 XBRL)。旧分類のみの企業 / REIT / ETF / 外国法人は marketSegment=null で、market 指定時は除外される。レスポンス各行に marketSegment を含む。注意: preset 指定時は market も含めて conditions/sort/market の各 query は無視される (preset 固有の filter / score を使う)。2026-06-28 追加。

fiscal_year_endinteger

決算月でフィルタ(1-12)。出典は既存の company_earnings_calendar.fiscal_year_end_month(決算カレンダー機能で既に算出・キャッシュ済みの値、既存フィールドのパラメータ化)。同一企業で複数カレンダー行がある場合は最頻値を採用。決算カレンダー未収録の企業は fiscal_year_end 指定時のみ除外される。2026-07-24 追加

sortstring

ソート指標(省略時は最初の condition の metric)。絞り込み条件ではないため、conditions/preset なしで sort/order のみを指定しても企業は絞り込まれず400になる。エイリアス sort_by も同様に受理される(sort が同時指定された場合は sort が優先)。

sort_bystring

sort のエイリアス(MCP screen_companies ツールの引数名と同名のため受理。sort が同時指定された場合は sort が優先)。chk 2026-07-25 追加

order'asc' | 'desc'

ソート順(asc/desc)。sort と同様、絞り込み条件ではない。エイリアス sort_order も同様に受理される(order が同時指定された場合は order が優先)。

sort_order'asc' | 'desc'

order のエイリアス(order が同時指定された場合は order が優先)。chk 2026-07-25 追加

limitinteger
offsetinteger
business_tagsstring

[DEPRECATED 2026-08-17] 撤去済み。grounding監査で非支持率20.0%・取りこぼし88%が 判明したため。パラメータは受理されますが無視され(結果は絞り込みなし)、レスポンスに business_tags 配列は含まれません。meta.deprecated_params で機械可読に告知されます。

Response

スクリーニング結果

Changes

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