SEC Financial Statements API: XBRL Company Facts
收藏数据链接：
官方服务：
资源简介：
Pull XBRL company facts (Revenues, Assets, EPS or any us-gaap concept) reported to the SEC, by ticker or CIK, values sorted newest period first.
创建时间：
2026-09-09
原始信息汇总
SEC Financial Statements API: XBRL Company Facts 数据集总结
数据集概述
本API是SEC EDGAR XBRL公司概念API的实时代理，允许用户提取任何标准的us-gaap财务概念（如收入、资产、净亏损、每股基本收益等），这些数据为公司按财年期间报告的实际数值。
核心功能
- 公司搜索端点：
GET /sec/companies/search?q=—— 基于SEC官方的company_tickers.json文件进行股票代码或公司名称搜索。 - XBRL公司事实端点：
GET /sec/companies/{id}/facts/{concept}?limit=—— 获取指定us-gaap概念的所有报告值，按会计期末日期排序（最新优先）。
典型用途
该API专为以下场景构建：
- 财务分析工具
- 估值模型
- 金融科技仪表盘
- 研究管线
其核心优势在于能够获取结构化、按期间划分的XBRL数据，无需手动解析XBRL申报文件。
数据来源与许可
- 数据来源：美国证券交易委员会（SEC EDGAR）的XBRL框架API。
- 许可：属于美国政府公共领域工作，可自由使用。
范围与限制（Honest Scope）
- 本API是data.sec.gov XBRL API的实时代理，具有24小时TTL的边缘缓存。
- SEC EDGAR自身可用性不提供SLA保证。
- 覆盖范围仅限于us-gaap税则体系概念（不包括自定义/扩展标签）。
- 仅申报XBRL标记报表的公司（公开报告公司）才拥有数据。
- 若公司从未报告某个概念，API返回404错误，而非零值。
定价方案
| 方案 | 月费 |
|---|---|
| BASIC | $0.00 |
| PRO | $12.00 |
| ULTRA | $39.00 |
| MEGA | $99.00 |
错误码说明
API返回的JSON错误格式为 { "error": "<code>", "message": "<text>" }，具体包括：
INVALID_COMPANY_ID(400) —— 无效公司IDINVALID_QUERY(400) —— 搜索关键词须为1-60字符INVALID_CONCEPT(400) —— 概念须为2-80个字母INVALID_LIMIT(400) —— 范围必须在1-200之间NOT_FOUND(404) —— 概念未出现在公司报告或未知的股票代码/CIKUPSTREAM_UNAVAILABLE(503) —— 上游超时、出错或返回无效JSONUPSTREAM_RATE_LIMITED(429) —— 上游限流METHOD_NOT_ALLOWED(405) —— 仅支持GET方法QUERY_TOO_LONG(414) —— 查询字符串超过512字符
示例
请求：GET /sec/companies/AAPL/facts/Revenues
返回包含CIK、公司名称、概念、标签、描述及按美元计价的多年财务数据，例如展示苹果公司2022与2023财年的营收金额及对应申报表（10-K）。
元数据
- 分类：Financial（金融）
- API创建者：Automator Labs
- 订阅者数：1
- 当前版本：v1 (当前)
