TDnet/適時開示ファイル取得(/td/files)
GET /v2/td/files
APIの概要
開示番号(discNo)に対応するファイルのダウンロードURLを取得できます。
取得したURLを使用してPDFやXBRLファイルをダウンロードできます。URLの有効期限は15分です。
本APIの留意点
- 本APIはTDnet/適時開示情報アドオンが必要です。
- データ取得可能期間は過去5年間です。
- ダウンロードURLの有効期限は15分です。
適時開示ファイルのダウンロード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/filescurl -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"
}
}