EDINET API v2 怎麼用：書類一覽、書類取得與 API 金鑰的官方規格
EDINET API v2 分 2 種且需 API 金鑰；有報可取 10 年，當日資料約每 1 分鐘更新。
想自己整理日本上市公司的財報，最直接的官方資料來源是金融廳營運的 EDINET（有價證券報告書等的電子揭露系統）。除了網頁查詢，EDINET 也提供 Web-API，讓程式能自動取得提出書類。金融廳企業開示課在 2026 年 6 月更新了《EDINET API 規格書（Version 2）》，把介面、認證、取得範圍與更新時間寫得很明確。本篇依該規格書整理：API 有哪些、要怎麼拿金鑰、可取得多久以前的書類、資料何時更新，以及使用上的限制。內容為官方規格摘要，不含任何投資建議；詳細欄位與錯誤碼請以規格書為準。
兩種 API
規格書第 1 章說明，EDINET 提供：
- 書類一覽 API：取得 EDINET 提出書類的一覽，依日期把握提出書類資訊、書類資訊修正資訊等。可選「只取 metadata」或「提出書類一覽加 metadata」（metadata 是每日提出書類一覽的基本資訊，含件數、更新日時等）。
- 書類取得 API：取得已提出的書類，以請求參數指定書類種類。
規格書建議的基本用法是：先用書類一覽 API 取 metadata → 確認件數是否比上次增加（沒增加就不用處理後續）→ 再取提出書類一覽 → 讀取內容找出需要的書類 → 用書類取得 API 取書類。
請求格式與金鑰
書類一覽 API 的 URL 結構為：https://api.edinet-fsa.go.jp/api/v2/documents.json?date=YYYY-MM-DD&type=1或2&Subscription-Key=API金鑰。參數：date 必須（檔案日期，YYYY-MM-DD）；type 為 1（只取 metadata，預設）或 2（提出書類一覽加 metadata）；Subscription-Key 必須，需先建立帳戶並發行 API 金鑰（規格書第 2 章）。檔案日期可指定當日以前、距最近財務局營業日 24 時未滿 10 年的日期，包括週末與假日。
書類取得 API 的 URL 為：https://api.edinet-fsa.go.jp/api/v2/documents/書類管理番號?type=必要書類&Subscription-Key=API金鑰。type 為 1（提出本文書及審計報告書，ZIP）、2（PDF）、3（代替書面、添付文書，ZIP）、4（英文檔案，ZIP）、5（CSV，由 XBRL 轉成，ZIP）。取得 XBRL 或 CSV 前，須看書類一覽的 XBRL 有無旗標或 CSV 有無旗標。
兩者都使用 GET 方法與 TLS 1.2 以上的加密通信。規格書也特別提醒：EDINET API 不允許跨網域通信，不能由瀏覽器端 JavaScript 直接呼叫。
可取得的範圍：縱覽期間加延長期間
API 的取得對象是「縱覽期間」與「延長期間」內的書類，兩者合稱「閱覽期間」。規格書列出：有價證券報告書縱覽 5 年加延長 5 年，共 10 年；半期報告書同為 5 年加 5 年（2024 年 4 月 1 日以後提出者適用延長）；四半期報告書縱覽 3 年加延長 7 年，共 10 年。延長期間內的書類，提出公司的內容訂正可能不像縱覽期間那樣被處理。
資料更新時間
規格書第 3 章說明：當日分的資料，從日本時間 8 時 30 分過後起，原則上每 1 分鐘更新，即使內容沒變也會替換檔案；過去日期的資料每日更新一次，從日本時間 24 時過後開始，並刪除已過 10 年的檔案。當日分檔案在日次更新最後才建立，所以當日檔案可取得，代表前一日資料已確定。另外，提出書類一覽記載的書類，有時 EDINET 上已不公開，此時書類取得 API 無法取得。
規格書的其他重點
規格書還說明取下書類、財務局職員修正書類資訊、不開示書類，以及提出者資訊變更（EDINET 代碼本身可能變更）等情形，在書類一覽中會以區分欄位反映。使用上須遵守 EDINET 的利用規約。此外，EDINET 的資料頁同時提供「EDINET 代碼集約一覽」（CSV 檔，2026 年 10 月 14 日更新），可用來對照提出者的 EDINET 代碼；EDINET 代碼與證券代碼的差別，見本站〈EDINET 代碼、證券代碼與法人編號的差別〉。
本篇依據的是 2026 年 6 月版規格書（全文 97 頁），日後修訂時以金融廳公布的最新版為準。
怎麼做
- 閱讀規格書第 2 章，建立帳戶並發行 API 金鑰。
- 在伺服器端程式（而非瀏覽器）呼叫 API。
- 先取 metadata 看件數是否增加，再取書類一覽。
- 取書類時，依需要選擇 type（1 到 5），並檢查 XBRL 與 CSV 旗標。
- 注意閱讀期間、每日更新時間與書類是否已不公開。
容易踩雷
- 在網頁 JavaScript 直接呼叫 API；規格書不允許跨網域通信。
- 以為資料永遠可取；有報的閱覽期間共 10 年。
- 忽略當日資料約每分鐘更新與過去資料每日更新的差別。
- 把書類一覽中的書類都當作可取得；已不公開者無法取得。
常見問題
EDINET API 需要金鑰嗎？
需要，兩種 API 都須帶 Subscription-Key。
可以查到多久以前的資料？
檔案日期須在距最近財務局營業日 24 時未滿 10 年；有報可閱覽 10 年。
資料多久更新一次？
當日分約每 1 分鐘，過去分每日一次。
能取得 CSV 嗎？
可以，type=5，須書類一覽的 CSV 旗標為 1。