REST 接口 · 文档目录

美股 10-K 年报章节 · REST 接口

10-K 年报章节。获取年度 10-K 申报文件中关键叙述章节的纯文本提取,包括业务概述与风险因素,以结构化的、便于 AI 处理的格式提供公司运营、战略、市场与重大风险的详细信息。

GET /stocks/filings/10-K/vX/sections
上游时效说明

每日更新

上游历史范围

该接口不适用

适用场景

  • 自然语言处理与文本分析、自动化风险画像、竞争基准比较、主题建模、摘要生成、大模型知识库构建。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
cikstringNoSEC 中央索引键(CIK),10 位、左侧补零。
cik.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
cik.gtstringNo筛选大于该值。
cik.gtestringNo筛选大于或等于该值。
cik.ltstringNo筛选小于该值。
cik.ltestringNo筛选小于或等于该值。
tickerstringNo该公司的股票代码。
ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
ticker.gtstringNo筛选大于该值。
ticker.gtestringNo筛选大于或等于该值。
ticker.ltstringNo筛选小于该值。
ticker.ltestringNo筛选小于或等于该值。
sectionstringNo申报文件中的标准化章节标识(如 business、risk_factors 等)。
section.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
filing_datestringNo申报文件提交至 SEC 的日期(格式 YYYY-MM-DD)。值格式须为 yyyy-mm-dd。
filing_date.gtstringNo筛选大于该值。值格式须为 yyyy-mm-dd。
filing_date.gtestringNo筛选大于或等于该值。值格式须为 yyyy-mm-dd。
filing_date.ltstringNo筛选小于该值。值格式须为 yyyy-mm-dd。
filing_date.ltestringNo筛选小于或等于该值。值格式须为 yyyy-mm-dd。
period_endstringNo该申报文件对应的报告期末日期(格式为 YYYY-MM-DD)。取值必须为 yyyy-mm-dd 格式。
period_end.gtstringNo筛选大于该值。值格式须为 yyyy-mm-dd。
period_end.gtestringNo筛选大于或等于该值。值格式须为 yyyy-mm-dd。
period_end.ltstringNo筛选小于该值。值格式须为 yyyy-mm-dd。
period_end.ltestringNo筛选小于或等于该值。值格式须为 yyyy-mm-dd。
limitintegerNo限制返回结果的最大数量。未指定时默认为 10,允许的最大值为 100。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 period_end,排序方向默认为 desc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].cikstringSEC 中央索引键(CIK),10 位、左侧补零。
results[].filing_datestring申报文件提交至 SEC 的日期(格式 YYYY-MM-DD)。
results[].filing_urlstring完整申报文件的 SEC 来源链接。
results[].period_endstring该申报文件对应的报告期末日期(格式为 YYYY-MM-DD)。
results[].sectionstring申报文件中的标准化章节标识(如 business、risk_factors 等)。
results[].textstring该章节的完整原始文本内容,含标题与格式。
results[].tickerstring该公司的股票代码。
statusenum: OK本次请求响应的状态。

响应示例

{
  "count": 2,
  "next_url": "https://api.massive.com/stocks/filings/10-K/vX/sections?cursor=eyJsaW1pd...",
  "request_id": "a3f8b2c1d4e5f6g7",
  "results": [
    {
      "cik": "0000320193",
      "filing_date": "2023-11-03",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/0000320193-23-000106.txt",
      "period_end": "2023-09-30",
      "section": "risk_factors",
      "text": "Item 1A. Risk Factors\n\nInvesting in our stock involves risk. In addition to the other information in this Annual Report on Form 10-K, the following risk factors should be carefully considered...",
      "ticker": "AAPL"
    },
    {
      "cik": "0000789019",
      "filing_date": "2023-07-27",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/789019/0000950170-23-035122.txt",
      "period_end": "2023-06-30",
      "section": "risk_factors",
      "text": "Item 1A. RISK FACTORS\n\nOur operations and financial results are subject to various risks and uncertainties...",
      "ticker": "MSFT"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗