---
title: "類似開示検索 (層A: メタデータ類似、プレビュー)"
method: GET
path: "/disclosures/search"
tags: ["IR PDF Distribution"]
---

# 類似開示検索 (層A: メタデータ類似、プレビュー)

`GET /disclosures/search`

## Request

- Base URL: `https://edinetdb.jp/v1`
- URL: `https://edinetdb.jp/v1/disclosures/search`
- Auth: API key in header `X-API-Key`

適時開示 (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 は広いカテゴリを含む)。

## Query parameters

- `event_subtype` string[]
- `industry` string
- `performance_state` string[]
- `q` string
- `since` string, date
- `until` string, date
- `similar_to` string
- `limit` integer

## Response `200`

検索結果 (meta.reference は similar_to 指定時のみ非null)

## Other responses

- `400`: パラメータ不正 / similar_to の基準開示が対応5 subtype 外 (unsupported_similarity_type)
- `404`: 機能プレビュー中 / similar_to の doc_id が見つからない

---

[API](https://skmtc.dev/edinetdb/apis/edinet-db-api.md) · [All operations](https://skmtc.dev/edinetdb/apis/edinet-db-api/llms.txt) · [OpenAPI document](https://skmtc.dev/edinetdb/apis/edinet-db-api/revisions/d896c5f7d472?raw)