# TDnet/適時開示インデックス一括ダウンロード(/td/bulk)

`GET`    /v2/td/bulk

## APIの概要

過去5年分の適時開示のインデックス情報を収録したCSVファイル（gzip圧縮）のダウンロードURLと最終更新日時を取得できます。\
取得したURLを使用してCSVファイルをダウンロードできます。URLの有効期限は15分です。

### 本APIの留意点

> **Info**
>
> - 本APIはTDnet/適時開示情報アドオンが必要です。
> - CSVには過去5年分の開示情報が含まれます。
> - ダウンロードURLの有効期限は15分です。
> - CSVファイルはgzip形式で圧縮されています。

## 適時開示インデックスの一括ダウンロードURLを取得します

`GET` `https://api.jquants.com/v2/td/bulk`

### Requests

### Headers

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー       |

### Query Parameters

クエリパラメータはありません。

### APIコールサンプルコード

/v2/td/bulk

**cURL**

```bash
curl -G https://api.jquants.com/v2/td/bulk \
-H "x-api-key: {{apiKey}}"
```

**JavaScript**

```javascript
import axios from 'axios'

const client = axios.create({
  baseURL: 'https://api.jquants.com',
  headers: { 'x-api-key': '{{apiKey}}' },
})

await client.get('/v2/td/bulk')
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
    "https://api.jquants.com/v2/td/bulk",
    headers=headers,
)
print(resp.json())
```

### Responses

### データ項目概要

| Parameter   | Type   | Required | Description                                          |
| ----------- | ------ | -------- | ---------------------------------------------------- |
| lastUpdated | string | Required | CSVファイルの最終更新日時（ISO 8601形式、e.g. 2025-04-01T08:00:00Z） |
| url         | string | Required | CSVファイル（gzip圧縮）のダウンロードURL                            |

### レスポンスサンプル

```bash {{ title: "200:OK" }}
{
    "lastUpdated": "2025-04-01T08:00:00Z",
    "url": "https://example.com/download-url-bulk-csv"
}
```

## CSVデータ項目

| Parameter  | Type   | Required | Description                                            |
| ---------- | ------ | -------- | ------------------------------------------------------ |
| DiscNo     | string | Required | 開示番号（14桁）                                              |
| Code       | string | Required | 銘柄コード                                                  |
| Name       | string | Required | 会社名                                                    |
| DiscDate   | string | Required | 開示日（YYYY-MM-DD）                                        |
| DiscTime   | string | Required | 開示時刻（HH:MM）                                            |
| Title      | string | Required | 開示タイトル                                                 |
| DiscStatus | string | Required | 取扱属性（null: 新規開示情報、'revision': 訂正開示情報、'delete': 削除開示情報） |
| RevNo      | string | Required | 開示履歴番号（1～99）                                           |
| DiscItems  | string | Required | 公開項目コード（`\|` 区切り）                                      |
| Docs       | string | Required | 添付書類種別（`\|` 区切り）（g: 全文情報PDF、s: サマリ情報PDF、x: XBRL関連ファイル） |

## CSVデータサンプル

```csv
DiscNo,Code,Name,DiscDate,DiscTime,Title,DiscStatus,RevNo,DiscItems,Docs
20250401130100,86970,日本取引所グループ,2025-04-01,08:00,2025年3月期 決算短信〔日本基準〕（連結）,,1,140120,g|s|x
20250401130200,86970,日本取引所グループ,2025-04-01,09:00,2025年3月期 有価証券報告書,,1,140120,g|x
```