API 文档
接口地址: https://api.gugudata.com/stock/hk/bulletin
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/stock/hk/bulletin?appkey=APPKEY&symbol=&pageindex=1&pagesize=10&language=en&sortorder=desc&reporttype=&year=
数据预览: 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 |
是 |
APPKEY |
付费后获取的 APPKEY。文档示例默认通过 Query 参数 appkey 传递;历史 Form 或 JSON body 中的 appkey 仍兼容。 |
| symbol |
string |
是 |
|
港股股票代码,必填,示例:00814、01378。具体值参见 港股股票代码参数枚举页面。 |
| pageindex |
integer |
否 |
1 |
分页页码,从 1 开始,默认值为 1。 |
| pagesize |
integer |
否 |
10 |
每页返回条数,默认值为 10,取值范围为 1~20。 |
| language |
string |
否 |
en |
公告语言,可选 en 或 zh;en 表示英文公告,zh 表示繁体中文公告,默认 en。 |
| sortorder |
string |
否 |
desc |
公告发布时间排序方式,可选 desc 或 asc;desc 表示倒序,asc 表示正序,默认 desc。 |
| reporttype |
string |
否 |
|
报告类型过滤,可选 annual 或 interim;annual 表示年报 PDF,interim 表示中报 PDF。不传时返回普通公告列表。 |
| year |
integer |
否 |
|
报告所属年度,格式为 4 位年份。例如 year=2025 表示查询 2025 年报或 2025 中报,不按公告发布时间年份过滤。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
本次请求的参数摘要字符串。 |
| 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 |
公告文件类型,例如 PDF。 |
| Data.FileLink |
string |
公告文件下载链接。 |
| Data.BulletinDateTime |
string |
公告发布时间,格式 yyyy/MM/dd HH:mm。 |
| Data.UniqueId |
string |
公告唯一标识。 |