财务公告接口文档

查询上市公司公告标题、公告类型、摘要、披露日期和原文链接。

每日更新

历史覆盖：2026 年至今（首期回填范围）

请求参数

• apiname（string（finance_announcement），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（object，可选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbols（string|array<string>，可选）：股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。
• startdate（string，可选）：业务日期区间开始日期。
• enddate（string，可选）：业务日期区间结束日期。
• limit（integer，可选）：本次返回记录数，最大 2000。
• offset（integer，可选）：分页偏移量。
• period（string，可选）：精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。
• date（string，可选）：精确业务日期。报表类按报告期匹配，事件类按事件日期匹配；不能与 period/startdate/enddate 同时传。
• ann_startdate（string，可选）：披露日期区间开始日期。
• ann_enddate（string，可选）：披露日期区间结束日期。
• as_of（string，可选）：只返回该时点已经披露的数据，支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间；不传表示当前时点。
• version（string（latest / all），可选）：latest 返回每个业务记录的最新已披露版本；all 返回全部历史版本。
• keyword（string，可选）：标题或摘要关键词。
• announcement_type（string|array<string（financial_report / other / unknown）>，可选）：按统一公告类型筛选：financial_report=财务报告，other=其他，unknown=未知。

返回字段

• symbol（string）：股票代码
• event_date（string）：公告披露日期或时间
• title（string）：公告标题
• summary（string|null）：公告摘要
• announcement_type（string）：公告类型：financial_report、other 或 unknown
• content_url（string|null）：公告原文链接