EDGAR 免費資料怎麼批次查?先把 ticker 對到 CIK,再讀 submissions JSON
股票代號會變、CIK 較穩定;先用 SEC 官方對照檔確認公司,再用 submissions JSON 讀表單與申報日期,可降低抓錯公司或把資料期間當申報日的風險。
搜尋一家公司時,股票代號最直覺,但它不是 EDGAR 的核心識別碼。代號可能因改名、併購或上市市場調整而變動;SEC 用 Central Index Key(CIK)辨識申報人。若直接把網路上的 ticker 塞進第三方 API,很容易抓到同名公司、舊代號或不同證券。
資料基準:2026 年 8 月 31 日;來源於 2026 年 9 月 1 日重新查核。 本文只說明 SEC 公開資料的查核流程,不評估任何公司、不提供選股、目標價或報酬承諾。
第一步:用 SEC 官方對照檔確認身分
SEC 的 company_tickers_exchange.json 列出 CIK、公司名稱、ticker 與交易所。實務上先比對至少三項:公司法定名稱、股票代號、交易所。若同一發行人有不同股別,也不能只看相似代號就合併。
CIK 在網址中通常要補成 10 位數。例如原始 CIK 是 320193,API 路徑使用 CIK0000320193.json。這只是格式示例,不表示本文推薦該發行人。想先理解識別碼,可讀本站的 [CIK 是什麼](/guide/us-cik-explained/);需要一般介面操作則看 [SEC EDGAR 查詢指南](/guide/us-sec-edgar-guide/)。
第二步:分清 submissions JSON 的欄位
SEC 的 submissions JSON 會列出近期申報及歷史檔案索引。常用欄位不能互換:
form是表單類型,例如 10-K、10-Q、8-K 或它們的修正版;filingDate是向 SEC 申報的日期;reportDate是該申報涵蓋的報導期間或事件日期欄位,不一定等於申報日;accessionNumber是一次申報的唯一編號,可用來組成原始檔案路徑;primaryDocument指向主要文件,但重要附件可能在同一申報的文件清單中。
因此,不能只看到最近日期就說「公司剛公布這季數據」,也不能把 reportDate 當成市場取得資訊的時間。研究財務比率前,可先回到 [財務指標基礎](/guide/us-financial-metrics-basics/)確認分子、分母與期間一致。
第三步:開原始文件並檢查修正版
JSON 適合篩選,不應取代原始申報。把 accession number 對到 filing detail 後,至少核對表單類型、申報日、報導期間、主要文件與 exhibits。若出現 10-K/A、10-Q/A 或其他 /A 表單,代表有修正申報;要讀修正說明,不能默認整份報告所有數字都重做,也不能沿用舊版結論。
submissions 適合找申報清單;companyfacts 則把 Inline XBRL facts 依 taxonomy、tag 與 units 彙整。後者方便比較期間,仍要用 form、filed、accn 回到原始文件核對定義、單位與重述。抓大量資料時應使用可識別的 User-Agent、控制請求速率並快取不變資料。遇到 403 或速率限制,應停止重試、降低頻率,而不是輪替位址繞過限制。其他免費來源可由本站 [美股免費資料來源](/guide/us-free-data-sources/)延伸,但關鍵主張仍應回到 EDGAR 原件。
一個可重複的查核清單
- 從官方 ticker 對照檔取得 CIK,不手動猜測。
- 將 CIK 補成 10 位數後讀 submissions JSON。
- 以 form、filingDate、reportDate 篩選候選申報。
- 開啟 filing detail,核對主要文件、附件與
/A修正版。 - 記錄資料擷取日與 accession number,避免日後無法重現。
這套流程能提升資料血緣,卻不能保證資料沒有申報人錯誤,也不能把「已向 SEC 申報」解讀成 SEC 背書、內容正確或股價將上漲。
參考資料
- U.S. Securities and Exchange Commission:Accessing EDGAR Data
- U.S. Securities and Exchange Commission:EDGAR Application Programming Interfaces (APIs)