[DEMO] A 股上市公司公告

A 股上市公司公告
接口详情官网地址: https://www.gugudata.com/api/details/stockcnbulletin

查询沪深京 A 股上市公司公告

请求方法: GET
接口路径: /stock/cn/bulletin
调试地址: https://api.gugudata.com/stock/cn/bulletin/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数:

appkey (string, 必填): 购买本接口后获取的 APPKEY。

symbol (string, 必填): 6 位 A 股股票代码，例如 300450。

category (string, 可选): 公告分类，默认 all。支持 all、major_event、financial_report、financing、risk_warning、asset_restructuring、information_change、shareholding_change。

beginDate (string, 可选): 开始日期，格式 yyyyMMdd；未传时默认查询最近 30 天。

endDate (string, 可选): 结束日期，格式 yyyyMMdd；未传时默认当天。

pageIndex (integer, 可选): 页码，从 1 开始，默认 1。

pageSize (integer, 可选): 每页数量，默认 20，范围 1~100。单次日期范围最长 366 天。

返回字段:

DataStatus.RequestParameter: 本次请求的参数摘要。

DataStatus.StatusCode: 业务状态码。

DataStatus.StatusDescription: 状态说明。

DataStatus.ResponseDateTime: 响应时间。

DataStatus.DataTotalCount: 当前查询条件下的公告总数。

Data[].AnnouncementId: 公告唯一标识。

Data[].Symbol: 股票代码。

Data[].StockName: 股票名称。

Data[].Title: 公告标题。

Data[].AnnouncementType: 公告分类。

Data[].DisclosureDate: 公告披露日期。

Data[].PublishedAt: 公告发布时间。

Data[].DetailUrl: 公告原文详情链接。

Data[].RetrievedAt: 数据获取时间。

业务状态码与 HTTP：100/200 成功；501/400 参数错误；502/429 限流；503/403 订单到期；504/401 凭证缺失或无效；505/403 额度耗尽；900/500 内部错误；901/503 公告服务不可用。

鉴权：Query appkey、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 或 Bearer；多处相同值可共存，冲突返回 501。GET 不使用 JSON Body 鉴权。

可选参数空白表示未设置。日期使用北京时间，结束日期不能晚于当天；开始日期默认结束日期前 29 天。未知或重复参数返回 501。
查询分类是筛选条件，AnnouncementType 是公告具体业务类型，允许为空。DataTotalCount 为筛选后的完整公告总数，Data 为当前页数组。正式请求摘要不展示完整筛选值，Demo 展示完整公开示例输入。

请求参数

请求示例代码

返回响应