三市场年报抓取 API 接口文档

A 股 · 港股 · 美股 — 官方公告/披露数据接口

目录
  1. A 股 — 东方财富公告接口
  2. 港股 — 东方财富公告接口（港股通道）
  3. 美股 — SEC EDGAR 接口
  4. 共用：PDF 下载与公司信息

A 股 东方财富公告接口

适用于上交所（.SH）、深交所（.SZ）、北交所（.BJ）上市公司。

1. 获取公告列表

GET https://np-anotice-stock.eastmoney.com/api/security/ann
参数说明示例值
stock_list股票代码（交易所前缀.代码）1.600519（茅台）
ann_type固定为 AA
f_node一级分类1
s_node二级分类1
page_size每页条数（最大 100）100
page_index页码1
sr排序（-1 为倒序）-1
client_source固定web

stock_list 格式说明

交易所格式示例
上交所 SH1.{代码}1.600519
深交所 SZ0.{代码}0.000858
北交所 BJ0.{代码}0.430047

示例请求

GET https://np-anotice-stock.eastmoney.com/api/security/ann
  ?stock_list=1.600519
  &ann_type=A
  &f_node=1
  &s_node=1
  &page_size=100
  &page_index=1
  &sr=-1
  &client_source=web

返回结构（简化）

{
  "data": {
    "list": [
      {
        "art_code": "AN202504301234567890",
        "title": "贵州茅台2024年年度报告",
        "notice_date": "2025-04-30 00:00:00",
        "columns": [
          { "column_code": "001001001001001" }
        ]
      }
    ]
  }
}
年报筛选：栏目代码 001001001001001 = 年报，001001001002001 = 中报。也可用标题正则匹配：年年度报告(?!摘要)。

2. 获取公告详情（拿 PDF 链接）

GET https://np-cnotice-stock.eastmoney.com/api/content/ann
参数说明示例值
art_code公告代码（从列表接口获取）AN202504301234567890
client_source固定web
page_index固定1
{
  "data": {
    "attach_url": "https://pdf.dfcfw.com/pdf/H2_AN..._1.pdf",
    "attach_url_web": "...",
    "attach_size": "12345678"
  }
}
备用 PDF URL：如果详情接口失败，可直接拼接：https://pdf.dfcfw.com/pdf/H2_{art_code}_1.pdf

港股 东方财富公告接口（港股通道）

与 A 股共用同一套 API，但参数不同。

1. 获取公告列表

GET https://np-anotice-stock.eastmoney.com/api/security/ann
参数说明示例值
stock_list港股代码（5 位补零）00700（腾讯）
ann_type固定为 HH
f_node港股一级分类8
s_node不传—
page_size每页条数100
page_index页码1
sr排序-1
client_source固定web

示例请求

GET https://np-anotice-stock.eastmoney.com/api/security/ann
  ?stock_list=00700
  &ann_type=H
  &f_node=8
  &page_size=100
  &page_index=1
  &sr=-1
  &client_source=web
港股栏目代码：年报 011009001，中报 011009002。
港股标题特点：繁体中文，如"腾讯控股有限公司截至2024年12月31日止年度之年度报告"。

2. 获取公告详情

同 A 股，用 art_code 调同一详情接口。

3. 获取港股 F10 基本面数据

GET https://datacenter.eastmoney.com/securities/api/data/v1/get
参数说明示例值
reportName报表名（如 RPT_HKF10_FN_BALANCE）按需选择
columns返回字段按需指定
filter过滤条件(SECUCODE="00700.HK")
source固定F10
client固定PC

美股 SEC EDGAR 接口

数据来自美国 SEC 官方 EDGAR 系统，返回 HTML 格式（非 PDF）。

必须带 User-Agent：SEC 要求所有请求携带有效的 User-Agent 头，否则返回 403。
格式：User-Agent: your-app/1.0 your-email@example.com

Step 1：查 Ticker → CIK

GET https://www.sec.gov/files/company_tickers.json

返回全量 ticker→CIK 映射表：

{
  "0": { "cik_str": 320193, "ticker": "AAPL", "title": "Apple Inc." },
  "1": { "cik_str": 789019, "ticker": "MSFT", "title": "MICROSOFT CORP" },
  ...
}

遍历找到目标 ticker，取 cik_str，补零到 10 位。

Step 2：获取公司提交记录

GET https://data.sec.gov/submissions/CIK{cik}.json

将 CIK 补零到 10 位代入，如 Apple：CIK0000320193.json

{
  "fiscalYearEnd": "0928",
  "filings": {
    "recent": {
      "form":           ["10-K", "10-Q", ...],
      "accessionNumber": ["0000320193-24-000123", ...],
      "primaryDocument": ["aapl-20240928.htm", ...],
      "filingDate":      ["2024-11-01", ...],
      "reportDate":      ["2024-09-28", ...]
    }
  }
}

Step 3：拼接文件 URL

GET https://www.sec.gov/Archives/edgar/data/{cik_number}/{accession_no_dashes}/{document}

示例（Apple 10-K）

https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm
表单类型说明source_type
10-K年度报告annual_report
10-Q季度报告quarterly_report
注意：SEC 返回的是 HTML 而非 PDF。如需 PDF，可用第三方工具转换，或使用 sec.gov 的 XBRL viewer。

完整流程

company_tickers.json → 取 CIK → submissions/CIK{cik}.json → 过滤 10-K / 10-Q → 拼接文件 URL

共用说明

PDF 下载

A 股和港股的年报 PDF 直接从 attach_url 下载。文件较大（通常 10-50MB），建议设置较长超时。

年份截断

类型默认回溯年数
年报10 年
中报3 年
季报3 年

代码格式对照

市场输入格式示例
A 股{代码}.{SH|SZ|BJ}600519.SH
港股{代码}.HK00700.HK
美股{TICKER}.USAAPL.US

东方财富接口通用说明

SEC EDGAR 接口通用说明

生成于 2026-06-22 · 仅供内部参考