J-Quants API
Markdownを表示

TDnet/適時開示ファイル取得(/td/files)

GET /v2/td/files

APIの概要

開示番号（discNo）に対応するファイルのダウンロードURLを取得できます。
取得したURLを使用してPDFやXBRLファイルをダウンロードできます。URLの有効期限は15分です。

本APIの留意点

  • 本APIはTDnet/適時開示情報アドオンが必要です。
  • データ取得可能期間は開示日から過去5年間です。期間を経過したものはデータ形式(API/CSV)を問わず取得できなくなります。
  • ダウンロードURLの有効期限は15分です。
  • 適時開示が訂正された場合も、データ取得可能期間（過去5年間）内であれば、旧 DiscNo を指定して当時のファイルを取得いただけます。
  • 当日分の適時開示情報を随時取得される場合は、cursorを使った差分取得（cursor パラメータ）のご利用を推奨しております。
  • データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
  • データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。

適時開示ファイルのダウンロードURLを取得します

GET https://api.jquants.com/v2/td/files

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

discNostringrequired

開示番号（14桁）（e.g. 20250401130100）
適時開示インデックス一覧で取得した開示番号を指定します。

docsstringoptional

取得するファイルの種類（カンマ区切りで複数指定可能）
g: 全文情報PDF、s: サマリ情報PDF、x: XBRL関連ファイル
省略時は全種類を返却します（e.g. g or g,s,x）

APIコールサンプルコード

Request

GET
/v2/td/files
curl -G https://api.jquants.com/v2/td/files \
-H "x-api-key: {loading}" \
-d discNo="20250401130100"

Responses

データ項目概要

discNostring
開示番号（14桁）
filesobject
ファイルのダウンロードURL一覧
files.pdfstring
全文情報PDFのダウンロードURL
files.summaryPdfstring
サマリ情報PDFのダウンロードURL
files.xbrlstring
XBRL関連ファイルのダウンロードURL

レスポンスサンプル

{
    "discNo": "20250401130100",
    "files": {
        "pdf": "https://example.com/download-url-pdf",
        "summaryPdf": "https://example.com/download-url-summary",
        "xbrl": "https://example.com/download-url-xbrl"
    }
}

Was this page helpful?