API 文档
接口地址: https://api.gugudata.com/stock/hk/bulletin
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/stock/hk/bulletin?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&pageindex=1&pagesize=10&language=en&sortorder=desc&reporttype=annual&year=2025
数据预览: https://www.gugudata.com/preview/stockhkbulletin
接口测试: https://api.gugudata.com/stock/hk/bulletin/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
前置接口说明: 查询港股股票代码列表数据,支持分页查询
前置接口地址: https://api.gugudata.com/stock/hksymbols?appkey=YOUR_APPKEY&pageindex=YOUR_VALUE&pagesize=YOUR_VALUE
前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量,最大 20 条
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 包含股票编码、股票名称、股票中文名称
前置接口请求方式: GET
前置接口请求协议: HTTPS
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
YOUR_APPKEY |
付费后获取的 APPKEY |
| symbol |
string |
是 |
YOUR_VALUE |
港股股票代码,具体值参见 港股股票代码参数枚举页面。支持一次查询多个股票,使用逗号隔开,参数格式为:00004,00012 |
| pageindex |
integer |
是 |
1 |
分页参数,从 1 开始,默认为 1 |
| pagesize |
integer |
是 |
10 |
分页参数,每页返回数量,最大 20 条,默认为 10 |
| language |
string |
否 |
en |
公告语言,可选 en | zh,en 英文,zh 繁体中文 |
| sortorder |
string |
否 |
desc |
公告时间排序,可选 desc | asc,表示按照发布时间倒序或正序查询 |
| reporttype |
string |
否 |
annual |
报告类型过滤,可选 annual | interim。annual 返回年报 PDF,interim 返回中报或半年度报告 PDF。不传时保持普通公告列表查询。 |
| year |
integer |
否 |
2025 |
报告所属年度,格式为 4 位年份,例如 2025。该参数按报告年度匹配,不是公告发布时间年份。需配合 reporttype 使用。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.StatusCode |
integer |
接口返回状态码 |
| DataStatus.StatusDescription |
string |
接口返回状态说明 |
| DataStatus.ResponseDateTime |
string |
接口数据返回时间 |
| DataStatus.DataTotalCount |
integer |
此条件下的总数据量,一般用于分页计算 |
| Data.Symbol |
string |
港股股票代码 |
| Data.StockName |
string |
股票名称 |
| Data.Title |
string |
公告标题 |
| Data.ShortText |
string |
公告简介 |
| Data.LongText |
string |
公告详情 |
| Data.FileSize |
string |
公告文件大小 |
| Data.FileType |
string |
公告文件类型 |
| Data.FileLink |
string |
公告文件链接 |
| Data.BulletinDateTime |
string |
公告时间 |
| Data.UniqueId |
string |
公告内部唯一 ID,中英文版本保持一致的唯一 ID |