類似開示検索 (層A: メタデータ類似、プレビュー)
適時開示 (disclosure_* 16 subtype) を対象に、業績状況 × イベント種別 × 業種 × タイトルキーワードで検索・類似ランキングする。
2つのモード:
- filter-only: event_subtype / industry / performance_state / q / since / until を組み合わせたフィルタ一覧 (published_at 降順)。全16 subtype が対象
- similar_to=<doc_id>: 指定した開示と「同じ event_subtype かつ他社」の中から、 業績状況の近さ (Jaccard) ・業種一致・タイトルキーワード重複 (文字bigram Jaccard) の加重和で類似スコア順にランキングする。event_subtype は基準開示から自動継承 (ハード条件、明示指定不要)。定義が明確な5 subtype のみ対応 (forecast_revision / personnel_org / stock_split / monthly_flash / treasury_stock)。基準開示がこの5種の外の場合は 400 (unsupported_similarity_type) を返す — キャッチオール型9種 (product_pr / financial_other / other / governance / correction / shareholder_related / statutory / dividend / equity_capital) に加え、 ma_reorg / special_pl も重み再校正後の機械ゲート再評価で18-32%と 構造的に弱いと実測されたため対象外。注: 5種への絞り込みは 最弱2種を除外するリスク低減であり、残る5種も評価基準では58-88%と幅があり 「7subtype ≥80%」という評価基準はいずれの重みでも未達。 プレビュー機能として参考程度に利用すること
本文全文・PDF直接リンクは返さない (発行元への言及のみ、法務判断前)。 similarity_breakdown に各要素スコアと重みを開示する (恣意ランキングにしない)。 業績データ欠損・業種不一致は「確証された無関係」として減点せず、加重和から その次元を除外し残り次元で再正規化する (weights=名目重み固定、 weights_applied/weight_sum=当該行で実際に使われた重みと再正規化分母。 similarity_score = Σ(weights_applied×各値)/weight_sum)。 各結果行の similarity_support (bool) で、その開示を similar_to の基準に できるか (=event_subtypeが上記5種か) を事前判定できる。
重要: プレビュー機能。プレビューが有効な環境でのみ動作。本番公開前は 404。 event_subtype の自動分類 (規則ベースと言語モデル) は投資判断用の精密分類ではなく 参考・検索補助用途 (特に statutory/correction は広いカテゴリを含む)。
Request
- Base URL: https://edinetdb.jp/v1
- URL: https://edinetdb.jp/v1/disclosures/search
- Auth: API key in header X-API-Key
Query parameters
16種 (product_pr / personnel_org / financial_other / governance / other / correction / monthly_flash / statutory / dividend / ma_reorg / forecast_revision / treasury_stock / equity_capital / stock_split / shareholder_related / special_pl)。similar_to 指定時は無視され、基準開示の event_subtype が自動的に使われる
業種 (companies.industry 完全一致)
OR条件。revenue_up_profit_up / revenue_up_profit_down / revenue_down_profit_up / revenue_down_profit_down / turnaround / deficit_fall / high_growth / underperform_industry。point-in-time 算出 (開示 published_at 時点で既に 公開済みの直近決算を用いる。look-ahead なし)
タイトル キーワード部分一致
基準となる doc_id。指定時は類似ランキングモードになる。基準開示の event_subtype が forecast_revision / personnel_org / stock_split / monthly_flash / treasury_stock の5種以外の 場合は 400 (unsupported_similarity_type)
Response
検索結果 (meta.reference は similar_to 指定時のみ非null)
Changes
No recorded changes to this operation across all 1 revision of this API.