数据查询

财务公告接口文档

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

接口参数与返回字段速查

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

每日更新

历史覆盖:2026 年至今(首期回填范围)

请求参数

  • apikey(string,必选):浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。
  • apiname(string(finance_announcement),必选):接口名称
  • fields(string|null,可选):| 字段 | 类型 | 名称 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbol` | `string` | 股票代码 | `000001` | 股票代码 | | `event_date` | `string` | 公告披露日期或时间 | `20260724` | 公告披露日期或时间 | | `title` | `string` | 公告标题 | `示例` | 公告标题 | | `summary` | `string\|null` | 公告摘要 | `示例` | 公告摘要 | | `announcement_type` | `string` | 公告类型 | `示例` | 公告类型:financial_report、other 或 unknown | | `content_url` | `string\|null` | 公告原文链接 | `示例` | 公告原文链接 |
  • params(object,可选):| 参数 | 类型 | 是否必选 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbols` | `string\|array` | 可选 | `000001,600000` | 股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。 | | `startdate` | `string` | 可选 | `20260101` | 业务日期区间开始日期。 | | `enddate` | `string` | 可选 | `20261231` | 业务日期区间结束日期。 | | `limit` | `integer` | 可选 | `500` | 本次返回记录数,最大 2000。 | | `offset` | `integer` | 可选 | `0` | 分页偏移量。 | | `period` | `string` | 可选 | `20260331` | 精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。 | | `date` | `string` | 可选 | `20260331` | 精确业务日期。报表类按报告期匹配,事件类按事件日期匹配;不能与 period/startdate/enddate 同时传。 | | `ann_startdate` | `string` | 可选 | `20260101` | 披露日期区间开始日期。 | | `ann_enddate` | `string` | 可选 | `20261231` | 披露日期区间结束日期。 | | `as_of` | `string` | 可选 | `2026-07-24T12:00:00+08:00` | 只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。 | | `version` | `string` | 可选 | `latest` | latest 返回每个业务记录的最新已披露版本;all 返回全部历史版本。 | | `keyword` | `string` | 可选 | `业绩说明会` | 标题或摘要关键词。 | | `announcement_type` | `string\|array` | 可选 | — | 按统一公告类型筛选:financial_report=财务报告,other=其他,unknown=未知。 |
  • ann_enddate(string,可选):披露日期区间结束日期。
  • ann_startdate(string,可选):披露日期区间开始日期。
  • announcement_type(string|array<string(financial_report / other / unknown)>,可选):按统一公告类型筛选:financial_report=财务报告,other=其他,unknown=未知。
  • as_of(string,可选):只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。
  • date(string,可选):精确业务日期。报表类按报告期匹配,事件类按事件日期匹配;不能与 period/startdate/enddate 同时传。
  • enddate(string,可选):业务日期区间结束日期。
  • keyword(string,可选):标题或摘要关键词。
  • limit(integer,可选):本次返回记录数,最大 2000。
  • offset(integer,可选):分页偏移量。
  • period(string,可选):精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。
  • startdate(string,可选):业务日期区间开始日期。
  • symbols(string|array<string>,可选):股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。
  • version(string(latest / all),可选):latest 返回每个业务记录的最新已披露版本;all 返回全部历史版本。

返回字段

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