DataBull

上市公司公告

公开接口

A股个股 A-Share · 上市公司公告列表

按证券代码查询 A 股上市公司的公告列表，可叠加标题关键词、日期区间与分类筛选。每条记录含公告标题、公告日期、分类，以及公告原文（PDF）直链与文件大小——本平台只提供原文链接，不代为解析 PDF 正文。

接口地址

GET /cn/stock/announcements
完整地址：https://api.databull.cn/cn/stock/announcements

接口说明

按证券代码查询 A 股上市公司的公告，可叠加标题关键词与日期范围筛选，每条含标题、公告日期、分类与公告原文（PDF）下载链接。

返回体为记录数组；分页信息通过响应头 X-Total-Count / X-Page / X-Page-Size / X-Has-More 返回；无命中时响应头带 X-Empty-Reason。

请求参数

参数位置类型必填默认说明
stock查询string是—证券代码（裸码，不带交易所后缀），必填
keyword查询string？否标题关键词，模糊匹配（不区分大小写，% 与 _ 按字面匹配）；留空表示不限
start_date查询string？否公告开始日期（含当天），YYYYMMDD 或 YYYY-MM-DD；留空不限制
end_date查询string？否公告结束日期（含当天），YYYYMMDD 或 YYYY-MM-DD；留空不限制
category查询string？否公告分类码精确匹配；留空表示不限
page查询integer否1页码，从 1 开始；不小于 1
page_size查询integer否20每页条数，最大 100；取值 1~100

返回字段

字段类型说明
idnumber内部字段：主键，可直接忽略
stock_codestring证券代码（裸码），如 600519
stock_namestring|null证券简称，如 贵州茅台
announcement_idstring公告唯一标识，与 stock_code 组成幂等键，同一条公告重复入库只刷新元数据
titlestring公告标题
announcement_datestring公告发布日期，YYYY-MM-DD
announcement_timestring|null公告发布时间，YYYY-MM-DD HH:MM:SS
categorystring|null公告分类码；一条公告可能同时属于多个分类，多个码以 || 分隔
pdf_urlstring|null公告原文 PDF 直链，http 协议，可直接下载
pdf_size_kbnumber|nullPDF 文件大小（KB）
page_columnstring|null所属板块：SZZB 深主板 / SHZB 沪主板 / SZCY 创业板 / SHKCB 科创板 / BJS 北交所

接口示例

cURL
curl "https://api.databull.cn/cn/stock/announcements?stock=600519&keyword=回购&start_date=20260101" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_stock_announcements(stock="600519", keyword="转债", start_date="20260101", end_date="20260630")
print(result)

响应示例

JSON
[
  {
    "id": 1,
    "stock_code": "600519",
    "stock_name": "贵州茅台",
    "announcement_id": "1225399918",
    "title": "贵州茅台酒股份有限公司2026年第一次临时股东大会决议公告",
    "announcement_date": "2026-06-26",
    "announcement_time": "2026-06-26 18:32:41",
    "category": "01010503||010112",
    "pdf_size_kb": 253,
    "pdf_url": "http://static.cninfo.com.cn/finalpage/2026-06-26/1225399918.PDF",
    "page_column": "SHZB"
  }
]

错误码

状态码触发条件
400日期格式错误，或 start_date 晚于 end_date
401缺少或无效 API 凭证
403当前套餐不含 A 股数据域权限
429当日调用次数已用尽

说明

  • stock 为必填，且是裸 6 位代码（如 600519），不要带 .SH / .SZ 后缀。
  • 响应为记录数组（非信封结构），按公告日期倒序、同日按发布时间倒序。分页信息走响应头 X-Total-Count / X-Page / X-Page-Size / X-Has-More；page_size 最大 100。
  • keyword 只匹配标题（模糊、不区分大小写），% 与 _ 会按字面转义，不会被当成通配符。例如搜「转债」可筛出标题含该词的公告。
  • category 是精确匹配且需整段包含分类码，传错不会报错，只会返回空数组并在响应头带 X-Empty-Reason: no_match。
  • start_date / end_date 支持 YYYYMMDD 与 YYYY-MM-DD 两种写法，均含当天；留空表示该端不限制。
  • 公告元数据每日收盘后自动更新；库中保留的区间有限，查询远早的日期可能返回空数组（X-Empty-Reason: no_match）。
  • pdf_url 是 http（非 https）直链，直接下载即可；若客户端强制 https，需自行改写协议前缀。