TDnetSearch APIベータ版

このAPIはベータ版として提供しています。仕様は変わることがあります。

適時開示の検索と決算データの分析結果を、JSONで取得できます。利用にはAPIキーが必要です。

APIで提供するのは分析データです。PDFやXBRLの実データ(ファイル)のダウンロードは、APIでは行えません。開示の本文テキストは、検索結果の txt_url から取得できます。

個人での利用に限り、無保証で提供します。APIの提供には運営コストがかかるため、予告なくレートリミット(利用回数の制限)を設けたり、提供を中止したりすることがあります。

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)です。

MCPサーバー

AIアシスタントからは、MCPサーバーでこのAPIを使えます。MCPのページをご覧ください。

ご利用にあたって

  • 利用は個人での利用に限ります。
  • データの正確性・完全性や、APIの稼働を含め、一切保証しません。利用によって生じた損害について、責任を負いません。
  • APIキーは、当面は1ユーザーにつき1つです。
  • 運営コストがかかるため、予告なくレートリミットを設けたり、仕様の変更や提供の中止をしたりすることがあります。
  • PDFやXBRLの実データはダウンロードできません。レスポンスの pdf_url などはブラウザで閲覧するためのリンクです。開示の本文テキストは txt_url から取得できます。
  • 1つのキーにつき1日250回までです。取得は必要な銘柄に絞ってください。
  • 過度なアクセスがあった場合は、予告なくキーを無効にすることがあります。
  • キーは他人と共有しないでください。漏洩した場合は無効化して再発行してください。
TOP