このAPIはベータ版として提供しています。仕様は変わることがあります。
適時開示の検索と決算データの分析結果を、JSONで取得できます。利用にはAPIキーが必要です。
APIで提供するのは分析データです。PDFやXBRLの実データ(ファイル)のダウンロードは、APIでは行えません。開示の本文テキストは、検索結果の txt_url から取得できます。
個人での利用に限り、無保証で提供します。APIの提供には運営コストがかかるため、予告なくレートリミット(利用回数の制限)を設けたり、提供を中止したりすることがあります。
APIキーの発行には、ログインが必要です。
ログインAPIキーは X-API-Key ヘッダーで送ってください(おすすめ)。クエリの key でも送れますが、URLはサーバーや経路のログに記録されるので、ヘッダーを設定できない場合だけ使ってください。
ヘッダーで送る(curl)
curl -H "X-API-Key: tds_..." \ "https://tdnet-search.appspot.com/api/analyze/72030"
クエリで送る(URL)
https://tdnet-search.appspot.com/api/search?query=code:72030&key=tds_...
キーがない、または無効なキーの場合は 401 を返します。
呼び出しは1つのキーで1日250回まで(日本時間の0時にリセット)で、超えると 429 を返します。残りの回数はレスポンスヘッダーの X-RateLimit-Remaining でわかります。
| エンドポイント | 内容 |
|---|---|
GET /api/search | 適時開示の検索 |
GET /api/company/search | 銘柄の検索 |
GET /api/holder | 株主・役員の名前で銘柄を探す |
GET /api/analyze | 計算式によるランキング |
GET /api/expression/fields | ランキングで使える項目 |
GET /api/analyze/<code> | 個別銘柄の分析 |
GET /api/analyze/<code>/statements | 財務諸表(過去の決算) |
GET /api/analyze/<code>/history | 項目の時系列 |
GET /api/analyze/<code>/facilities | 主要な設備の状況 |
GET /api/analyze/<code>/securities | 有価証券の時価 |
GET /api/analyze/<code>/shareholdings | 保有株式(政策保有株式) |
GET /api/analyze/<code>/shareholders | 大株主の状況 |
GET /api/analyze/<code>/officers | 役員の状況 |
GET /api/analyze/<code>/remuneration | 役員報酬 |
GET /api/analyze/<code>/employees | 従業員の状況 |
GET /api/analyze/<code>/segments | セグメント情報 |
GET /api/analyze/<code>/business | 事業の内容 |
<code>は4桁の証券コード(7203)か、末尾に0を付けた5桁(72030)です。
AIアシスタントからは、MCPサーバーでこのAPIを使えます。MCPのページをご覧ください。
pdf_url などはブラウザで閲覧するためのリンクです。開示の本文テキストは txt_url から取得できます。