美股 10-K 年报章节 · REST 接口
10-K 年报章节。获取年度 10-K 申报文件中关键叙述章节的纯文本提取,包括业务概述与风险因素,以结构化的、便于 AI 处理的格式提供公司运营、战略、市场与重大风险的详细信息。
GET /stocks/filings/10-K/vX/sections上游时效说明
每日更新
上游历史范围
该接口不适用
适用场景
- 自然语言处理与文本分析、自动化风险画像、竞争基准比较、主题建模、摘要生成、大模型知识库构建。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
cik | string | No | SEC 中央索引键(CIK),10 位、左侧补零。 |
cik.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
cik.gt | string | No | 筛选大于该值。 |
cik.gte | string | No | 筛选大于或等于该值。 |
cik.lt | string | No | 筛选小于该值。 |
cik.lte | string | No | 筛选小于或等于该值。 |
ticker | string | No | 该公司的股票代码。 |
ticker.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
ticker.gt | string | No | 筛选大于该值。 |
ticker.gte | string | No | 筛选大于或等于该值。 |
ticker.lt | string | No | 筛选小于该值。 |
ticker.lte | string | No | 筛选小于或等于该值。 |
section | string | No | 申报文件中的标准化章节标识(如 business、risk_factors 等)。 |
section.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
filing_date | string | No | 申报文件提交至 SEC 的日期(格式 YYYY-MM-DD)。值格式须为 yyyy-mm-dd。 |
filing_date.gt | string | No | 筛选大于该值。值格式须为 yyyy-mm-dd。 |
filing_date.gte | string | No | 筛选大于或等于该值。值格式须为 yyyy-mm-dd。 |
filing_date.lt | string | No | 筛选小于该值。值格式须为 yyyy-mm-dd。 |
filing_date.lte | string | No | 筛选小于或等于该值。值格式须为 yyyy-mm-dd。 |
period_end | string | No | 该申报文件对应的报告期末日期(格式为 YYYY-MM-DD)。取值必须为 yyyy-mm-dd 格式。 |
period_end.gt | string | No | 筛选大于该值。值格式须为 yyyy-mm-dd。 |
period_end.gte | string | No | 筛选大于或等于该值。值格式须为 yyyy-mm-dd。 |
period_end.lt | string | No | 筛选小于该值。值格式须为 yyyy-mm-dd。 |
period_end.lte | string | No | 筛选小于或等于该值。值格式须为 yyyy-mm-dd。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 10,允许的最大值为 100。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 period_end,排序方向默认为 desc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].cik | string | SEC 中央索引键(CIK),10 位、左侧补零。 |
results[].filing_date | string | 申报文件提交至 SEC 的日期(格式 YYYY-MM-DD)。 |
results[].filing_url | string | 完整申报文件的 SEC 来源链接。 |
results[].period_end | string | 该申报文件对应的报告期末日期(格式为 YYYY-MM-DD)。 |
results[].section | string | 申报文件中的标准化章节标识(如 business、risk_factors 等)。 |
results[].text | string | 该章节的完整原始文本内容,含标题与格式。 |
results[].ticker | string | 该公司的股票代码。 |
status | enum: 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 文档 ↗