A 股上市公司公告

按股票代码、公告分类及日期区间查询公告标题、类型、披露日期、发布时间和详情链接。时间采用北京时间；未指定日期时查询最近 30 个自然日，单次最长 366 天。可选参数空白视为未设置；未知或重复参数返回 501。获取时间不是公告发布时间。

当前接口契约

接口详情：https://www.gugudata.com/api/details/stockcnbulletin

功能说明

按六位股票代码查询沪深京 A 股上市公司公告；

支持重大事项、财务报告与融资公告筛选；

支持风险提示、资产重组、信息变更与持股变动筛选；

可按起止日期查询，单次区间最长 366 个自然日；

未指定日期时查询最近 30 个自然日公告；

返回公告标识、股票代码、股票名称和公告标题；

分别提供公告类型、披露日期与发布时间；

提供公告详情链接，便于查看对应披露内容；

按发布时间倒序分页，每页最多 100 条并返回匹配总数；

返回本次数据获取时间，便于与公告发布时间区分；

请求参数

参数	类型	必填	默认值	说明
appkey	string	是	无	支持 Query appkey、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 或 Bearer；多个位置值必须一致，GET 不使用 JSON Body 鉴权。
symbol	string	是	无	必填。6 位 A 股股票代码，覆盖沪市、深市和北交所，保留前导零；不接受股票简称、市场前缀或多个代码。
category	string	否	all	公告分类。支持 all（全部）、major_event（重大事项）、financial_report（财务报告）、financing（融资公告）、risk_warning（风险提示）、asset_restructuring（资产重组）、information_change（信息变更）、shareholding_change（持股变动）。
beginDate	string	否	最近 30 天的起始日期	查询起始日期，格式为 yyyyMMdd。未传时按 endDate 向前计算最近 30 个自然日；单次查询区间最长 366 天。
endDate	string	否	当前日期	查询结束日期，格式为 yyyyMMdd，不能晚于当前日期；未传时使用当前日期。
pageIndex	integer	否	1	页码，从 1 开始。
pageSize	integer	否	20	每页数量，取值范围 1~100，默认 20。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	业务状态码：100 成功；501 参数错误；502 限流；503 订单到期；504 凭证缺失或无效；505 额度耗尽；900 内部错误；901 公告服务不可用。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff。
DataStatus.DataTotalCount	integer	当前查询条件下的公告总数，用于计算分页；正常无数据时为 0。
Data.AnnouncementId	string	公告唯一标识，可用于客户端增量同步和幂等去重。
Data.Symbol	string	公告所属的 6 位 A 股股票代码。
Data.StockName	string	股票简称。
Data.Title	string	公告标题。
Data.AnnouncementType	string	公告的具体业务类型。
Data.DisclosureDate	string	公告披露日期，格式为 yyyy-MM-dd。
Data.PublishedAt	string	公告发布时间，格式为 yyyy-MM-dd HH:mm:ss。
Data.DetailUrl	string	公告详情页面链接。
Data.RetrievedAt	string	本次数据获取时间，格式为 yyyy-MM-dd HH:mm:ss。

业务状态说明

业务状态码	业务状态码解释	备注
100	正常返回	无数据时 Data 为空数组
501	参数错误	HTTP 400
502	请求频率受限	HTTP 429
503	订单到期	HTTP 403
504	APPKEY 缺失或无效	HTTP 401
505	额度耗尽	HTTP 403
900	内部错误	HTTP 500
901	公告数据服务暂时不可用	HTTP 503

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 100
    },
    "Data": [
        {
            "Symbol": "string",
            "AnnouncementType": "string",
            "DisclosureDate": "string",
            "AnnouncementId": "string",
            "Title": "string",
            "PublishedAt": "string",
            "StockName": "string",
            "DetailUrl": "string",
            "RetrievedAt": "string"
        }
    ]
}

🟠400参数错误（业务码 501）。

🟠401APPKEY 缺失或无效（业务码 504）。

🟠403订单到期（业务码 503）；额度耗尽（业务码 505）。

🟠429请求频率受限（业务码 502）。

🔴500内部错误（业务码 900）。

🔴503公告数据服务暂时不可用（业务码 901）。

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明