查询报告公告列表

接口说明

项目	说明
接口名称	查询报告公告列表
外部接口	GET /api/v1/market/data/report-announcements/list
请求方式	GET
适用场景	按公告日期分页查询报告公告，可选按证券代码过滤；公告 ID 可用于查询公告摘要

同一处理逻辑的兼容入口还包括 /api/v1/market/data/report-announcement/list。

请求参数

参数名	类型	是否必填	描述	取值示例	备注
date	string	是	公告日期	20260714	YYYYMMDD 或 YYYY-MM-DD
sec_code	string	否	证券代码	600000	不传返回当天全部证券公告
page	int	否	页码	1	从 1 开始，默认 1
page_size	int	否	每页数量	50	默认 50，最大 200

执行方式

# 某日某证券公告
python <RUN_PY> report-announcement-list --date 20260714 --sec_code 600000 --page 1 --page_size 20
# 某日全部公告并翻全量
python <RUN_PY> report-announcement-list --date 20260714 --all

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。

响应结构

返回 code/message/data，分页数据位于 data.records。

{
  "code": 200,
  "message": "success",
  "data": {
    "pageNum": 1, "pageSize": 20, "total": 50, "pages": 3,
    "records": [
      {
        "id": 12345,
        "announcement_id": "AN202607140001",
        "url_hash": "...",
        "sec_code": "600000",
        "sec_name": "浦发银行",
        "announcement_title": "...",
        "announcement_time": "2026-07-14 09:30:00",
        "adjunct_type": "PDF", "adjunct_size": 102400,
        "column_type": "monthly", "plate": "sh",
        "status": "summarized", "retry_count": 0,
        "created_at": "2026-07-14 09:30:00",
        "updated_at": "2026-07-14 10:00:00",
        "processed_at": "2026-07-14 10:01:00"
      }
    ]
  }
}

data 字段

字段	类型	说明
pageNum	int	当前页码
pageSize	int	当前每页条数
total	int	满足条件的总记录数
pages	int	总页数；无记录时为 0
records	array	当前页公告记录

records 元素字段

字段	类型	说明
id	int64/null	数据库记录 ID
announcement_id	string/null	公告 ID
url_hash	string/null	公告附件哈希
sec_code / sec_name	string/null	证券代码 / 证券名称
announcement_title	string/null	公告标题
announcement_time	string/null	公告时间
adjunct_type	string/null	附件类型
adjunct_size	int64/null	附件大小
column_type	string/null	公告栏目类型
plate	string/null	所属板块
status	string/null	处理状态
retry_count	int64/null	重试次数
created_at / updated_at / processed_at	string/null	创建 / 更新 / 处理时间

注意事项

• date 为必填，支持 YYYYMMDD 或 YYYY-MM-DD。
• page_size 最大 200。
• 取得 announcement_id 后可调用 report-announcement-summary 查询公告摘要。
• 两个路径（/report-announcements/list 与 /report-announcement/list）均为 v1 兼容入口。