SEC EDGAR Filings API: 10-K, 10-Q, 8-K Lookup

Search SEC-registered companies by ticker or name and pull EDGAR filing history (10-K, 10-Q, 8-K and more) with direct document URLs, from data.sec.gov.

原始信息汇总

数据集概述

SEC EDGAR Filings API: 10-K, 10-Q, 8-K Lookup 是一个针对美国证券交易委员会（SEC）EDGAR 系统的实时代理接口，旨在帮助开发者便捷地查找上市公司档案信息。

核心功能：

• 通过股票代码（Ticker）或 CIK 编号解析公司档案，获取完整的公司简介。
• 查询公司的申报历史记录，包括 10-K、10-Q、8-K 等表单类型。
• 支持按名称或代码搜索约 10,000 家 SEC 注册公司。

主要端点：

• GET /sec/companies/search?q=：用于按名称或股票代码搜索公司。
• GET /sec/companies/{id}：获取公司简介，涵盖 SIC 代码、注册州、地址、曾用名及最新申报文件。
• GET /sec/companies/{id}/filings?form=&limit=&before=：返回申报历史，可按表单类型和日期筛选，并提供 EDGAR 文件投递链接。

典型示例：

• 请求 GET /sec/companies/AAPL 可返回 Apple Inc. 的详细档案数据，包括 CIK、交易所、SIC 代码、地址以及最近一次 10-K 申报的链接。
• 请求 GET /sec/companies/AAPL/filings 可返回包含 10-K、10-Q 等申报记录的列表，每条记录均含申报日期、接受日期、档案编号和 EDGAR 文档 URL。

适用场景：

• 合规与 KYB（Know Your Business）工具开发。
• 投资者关系仪表板构建。
• 金融科技尽职调查流程。
• 研究管线中需要机器可读的文件元数据，而无需抓取 EDGAR 的原始 HTML 页面。

数据来源与许可：

• 数据源自美国证券交易委员会（SEC EDGAR），属于美国政府的公共领域作品，可直接使用。

限制与说明：

• 该 API 为 data.sec.gov 的实时代理，具备边缘缓存机制（公司/申报缓存 6 小时，股票列表缓存 24 小时）。
• 不对 SEC EDGAR 自身的可用性提供 SLA 保障。
• 仅提供元数据和 URL 索引，不提供全文搜索或文档解析功能；申报正文需从返回的文档链接中获取。

错误处理：

• API 返回统一的 JSON 错误格式 { "error": "<code>", "message": "<text>" }，包含如 INVALID_COMPANY_ID、INVALID_QUERY、NOT_FOUND、UPSTREAM_UNAVAILABLE、UPSTREAM_RATE_LIMITED 等错误码，并设置 Cache-Control: no-store 头。