Free 10-K API
for SEC Filing Data免费 10-K API
获取 SEC 年报数据

Free 10-K API: what developers need to complete免费 10-K API：开发者真正要完成的任务

The direct answer is that SEC EDGAR provides a free, authoritative path to 10-K metadata, filed documents, exhibits, and tagged facts, but it is not a ready-made annual-report analytics API. The integration must still resolve the issuer, select the correct filing version, retrieve the required document layer, parse narrative sections or XBRL contexts, and retain enough evidence to reproduce every result.

直接答案是：SEC EDGAR 免费提供权威的 10-K 元数据、申报正文、附件和标签化事实，但它并不是开箱即用的年报分析 API。接入方仍需解析发行人、选择正确文件版本、下载所需文档层、处理叙述章节或 XBRL 上下文，并保留足够证据，使每个结果都能复现。

Choose the output from the research question. A filing monitor needs accession number and accepted time; a risk model needs Item 1A text and section boundaries; a financial model needs period-aware facts or normalized statements; an audit workflow may need the complete filing index and exhibits. Calling all of these “10-K data” hides important differences in completeness and validation.

应从研究问题反推输出。申报监控需要 accession number 与受理时间；风险模型需要 Item 1A 正文及章节边界；财务模型需要带期间上下文的 facts 或标准化报表；审计流程则可能需要完整文件索引和附件。把这些统称为“10-K 数据”，会掩盖完整性与验证方式上的关键差异。

SEC 10-K API outputs: filings, JSON, and XBRLSEC 10-K 数据接口的申报、JSON 与 XBRL 输出

The SEC’s public data APIs expose company submissions and extracted XBRL data as JSON. A submissions response can identify recent 10-K and 10-K/A records, while company facts expose tagged financial observations. Neither should be confused with a fully normalized income statement, balance sheet, or cash-flow API.

SEC 的公开数据 API 以 JSON 提供公司 submissions 与已提取的 XBRL 数据。submissions 可定位近期 10-K 与 10-K/A，company facts 可返回带标签的财务事实；二者都不等同于已经统一口径的利润表、资产负债表或现金流量表接口。

For document analysis, the primary 10-K HTML is only one part of the filing package. The filing index may also list exhibits, XBRL instance and taxonomy files, certifications, and documents incorporated by reference. Decide whether your application promises “the primary annual filing” or “the complete filed package,” because those are different completeness contracts.

对于文档分析，主要 10-K HTML 只是整套申报材料的一部分。文件索引还可能列出附件、XBRL 实例与分类文件、管理层认证，以及通过引用纳入的其他文件。应用必须明确承诺的是“主要年报正文”还是“完整申报材料”，因为两者对应不同的完整性标准。

10-K versus annual report and 10-K/A10-K、年度报告与 10-K/A 的区别

A Form 10-K is the SEC annual filing; a glossy shareholder annual report may be a separate document. Treat 10-K/A as an amendment, preserve both accessions, and avoid silently overwriting the original record.

Form 10-K 是提交给 SEC 的年度申报；面向股东的设计版年度报告可能是另一份文档。10-K/A 应作为修订文件处理，需保留原始与修订 accession，不能静默覆盖。

Amendments also need semantic review. A 10-K/A may change a limited disclosure rather than re-file every section, and proxy materials can supply information incorporated by reference. Store a version chain, identify which Items changed, and avoid presenting the amendment alone as though it were a complete restated annual report.

修订文件还需要语义层面的判断。10-K/A 可能只修改有限披露，并不会重新提交全部章节；代理声明也可能补充通过引用纳入的内容。应保存版本链、识别哪些 Item 发生变化，不能把单独的修订文件当作完整重述年报展示。

How to evaluate a free SEC filings API如何评估免费的 SEC 年报 API

Use a free 10-K API with Python使用 Python 接入免费 10-K API

Step 1: resolve ticker to CIK步骤 1：把股票代码映射为 CIK

Map the ticker to the SEC CIK and pad it to ten digits for company submissions requests. Store both identifiers because tickers can change while the CIK is the SEC’s stable entity key.

先把股票代码映射到 SEC CIK，并补足为 10 位用于 company submissions 请求。两种标识都应保存，因为 ticker 可能变化，而 CIK 是 SEC 的稳定实体键。

Record the mapping source and observation date. If one issuer has several listed share classes, decide whether the user is selecting a security or the reporting entity; EDGAR filing lookup ultimately operates on the entity CIK.

同时记录映射来源与观察日期。如果同一发行人有多个上市股份类别，还要区分用户选择的是证券还是申报主体；EDGAR 的文件查询最终以主体 CIK 为准。

Step 2: filter 10-K and 10-K/A records步骤 2：筛选 10-K 与 10-K/A

Fetch the submissions JSON, zip the parallel recent-filings arrays into records, and select exact form values. Preserve form, filing date, accession number, primary document, and report date.

获取 submissions JSON，将 recent filings 中的并行数组组合为记录，再按精确表单值筛选。保留 form、filing date、accession number、primary document 与 report date。

Do not assume the recent arrays contain the full history. Follow older-submission file references when the requested year is absent. Sort by accepted timestamp for “latest known filing” logic, and keep 10-K/A in a related but distinct version stream.

不要假设 recent 数组覆盖全部历史。如果目标年份不在其中，应继续读取引用的较早 submissions 文件。“当时已知的最新文件”应按 accepted timestamp 排序，10-K/A 则进入相关但独立的版本流。

Step 3: download or parse the required layer步骤 3：下载或解析所需数据层

Construct the SEC archive URL for the primary document when you need the filing text. Use XBRL company facts for tagged values or a documented third-party 10-K data API when the application needs normalized financial statements.

需要全文时，用 accession 与 primary document 构造 SEC 存档链接；需要标签值时使用 XBRL company facts；需要统一口径财务报表时，再选择文档明确的第三方 10-K 数据接口。

Cache the immutable source document and filing index before parsing. For section extraction, remove navigation and table-of-contents noise carefully, preserve tables where they carry meaning, and store parser version plus source offsets. For financial facts, keep concept, unit, period, dimensions, form, filed date, and accession number rather than selecting a value by label alone.

解析前先缓存不可变的原始正文与文件索引。提取章节时要谨慎去除导航和目录噪声，保留具有信息意义的表格，并记录解析器版本与来源位置。财务 facts 应保留 concept、单位、期间、维度、表格、申报日与 accession number，不能只按标签名称选取数值。

import requests

headers = {"User-Agent": "YourApp contact@example.com"}
cik = "0000320193"
data = requests.get(
    f"https://data.sec.gov/submissions/CIK{cik}.json",
    headers=headers,
    timeout=30,
).json()

recent = data["filings"]["recent"]
records = [dict(zip(recent, row)) for row in zip(*recent.values())]
annual = [r for r in records if r["form"] in {"10-K", "10-K/A"}]

Use QVeris to discover 10-K data capabilities使用 QVeris 发现 10-K 数据能力

For implementation concepts, review the QVeris documentation and keep the original SEC URL in downstream research output.

接入概念可参考 QVeris 文档，并在后续研究输出中保留 SEC 原始链接。

Free 10-K API questions免费 10-K API 常见问题

Authoritative references权威参考