依排程重新整理
用小型腳本每天拉取新的申報文件與數據。
閱讀指南 →所有 API
公司申報文件 API 清單與單筆紀錄
列出公司的申報文件、取得單筆申報文件記錄，或讀取各公司的最新申報文件，並附有監管機構官方文件的連結。
首次請求
列出公司的年度申報文件
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings?type=annual" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例
{
"id": "usa:0000789019",
"filings": [
{
"id": "usa:0000789019:0001193125-26-323660",
"date": "2026-07-29",
"type": "annual",
"title": "10-K"
}
]
}端點
GET列出公司的申報文件/v1/companies/{company_id}/filings
公司的申報文件，由新到舊，並附上每份官方文件的連結。
參數
company_id必填公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。
type選填申報文件類別，例如 annual。
回應欄位
id欄位申報文件的識別碼
date欄位申報文件的提交日期
type欄位申報文件類別，例如年度、季度、事件或持股
title欄位申報文件標題
url欄位監管機構網站上官方申報文件的連結
company_id欄位與申報文件相關之公司的識別碼
form欄位監管機構的表格代號，例如 10-K 或 13D
period_end欄位申報文件所涵蓋報告期間的結束日期
filing_id (on stock earnings)欄位涵蓋過往財報的年度、半年度或季度報告。將它傳給申報文件路由即可讀取該記錄。若沒有符合的申報文件，或沒有符合該日期的報告，則省略此欄位。
完整參考文件 →
GET取得各公司的最新申報文件/v1/filings/latest
GET取得申報文件記錄/v1/filings/{filing_id}
使用情境
涵蓋範圍
- 美國申報文件與財務報表。歷史資料自 2009 年起。
- 日本超過 3,800 家公司，涵蓋年報與半年報。
- 韓國目前約涵蓋一半的上市公司。
- 臺灣約 1,980 家公司。2026 年半年度報告。
- 歐盟與歐洲經濟區約 3,200 家公司，涵蓋 26 個國家，僅提供年報。
- 英國約 800 家受監管市場的公司，僅提供年報。
來源
- 美國SEC EDGAR
- 日本EDINET，金融廳
- 韓國DART，金融監督院
- 臺灣TWSE 與 TPEx 上市櫃公司
- 歐盟與歐洲經濟區ESEF 年度報告
- 英國英國受監管市場發行人
相關 API
透過 Narwhal 使用 SEC EDGAR API
來自 SEC EDGAR 的美國即時申報文件與標準化 XBRL 財務數字
探索 API →EDINET API 已上線涵蓋日本公司
日本申報文件與財務報表，已上線
探索 API →DART API 已涵蓋韓國公司
韓國申報文件與財務報表，已上線
探索 API →MOPS API 台灣申報文件與報表
來自 data.gov.tw 上 TWSE OpenAPI 與 TPEx 開放資料的台灣公司財務數字
探索 API →ESEF API 取得公司年度申報
來自 26 個歐盟與歐洲經濟區國家公司的年度報告
探索 API →受規範市場公司的英國財報 API
來自英國受監管市場發行人的年度報告
探索 API →常見問題
哪些表格涵蓋外國私人發行人？
表格 20-F 歸類為年度，表格 6-K 歸類為事件。
我可以用申報文件 ID 取得單一申報文件嗎？
使用 GET /v1/filings/{filing_id} 取得特定申報文件的記錄。
我可以在哪裡閱讀原始申報文件？
請依記錄的 url 前往監管機構網站上的官方文件。該文件仍是最終依據。
如何從財報找到對應的申報文件？
股票路由上的過往財報列，在我們持有涵蓋該財報的報告時，會附上申報文件 ID。將它傳給申報文件路由即可。財報 EPS 與申報文件財務數據中的 EPS 可能不同，因為財報數字採用市場資料基礎。
公司申報文件清單
依類型、表格與日期讀取公司的申報文件。
最新申報文件
透過單一端點取得各公司的最新申報文件。
官方連結
每筆記錄包含 ID、日期、類型、標題，以及官方申報文件的連結。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。