港股上市公司公告

港股公告检索与摘要归档

可通过 reporttype=annual 或 reporttype=interim 结合 year 参数，直接查询指定报告年度的年报或中报 PDF；year 表示报告所属年度，不是公告发布时间年份。

GET /stock/hk/bulletin

业务说明

支持港股上市公司公告查询，symbol 为必填港股代码；

支持 language=en 或 zh 查询英文或繁体中文公告；

支持 sortorder=desc 或 asc 控制公告发布时间排序；

可通过 reporttype=annual/interim 与 year 直达查询指定年度年报或中报 PDF；

返回公告文件链接，PDF 等公告原始文件可直接下载；

围绕“港股上市公司公告”提供标准化能力，便于快速接入现有业务；

适合将“港股上市公司公告”结果接入业务系统、后台工具和自动化流程；

适合行情看板、投研系统和自动化数据任务接入；

鉴权：需要 AppKey，使用本操作声明的鉴权位置。

请求参数

参数	位置	类型	必填	真实默认值	说明
appkey	query	string	否	无	付费后获取的 APPKEY。
symbol	query	string	是	无	港股股票代码，必填，示例：00814、01378。具体值参见港股股票代码参数枚举页面。
pageindex	query	integer	否	1	分页页码，从 1 开始，默认值为 1。
pagesize	query	integer	否	10	每页返回条数，默认值为 10，取值范围为 1~20。
language	query	string	否	en	公告语言，可选 en 或 zh；en 表示英文公告，zh 表示繁体中文公告，默认 en。
sortorder	query	string	否	desc	公告发布时间排序方式，可选 desc 或 asc；desc 表示倒序，asc 表示正序，默认 desc。
reporttype	query	string	否		报告类型过滤，可选 annual 或 interim；annual 表示年报 PDF，interim 表示中报 PDF。不传时返回普通公告列表。
year	query	integer	否	无	报告所属年度，格式为 4 位年份。例如 year=2025 表示查询 2025 年报或 2025 中报，不按公告发布时间年份过滤。

独立请求示例

{
  "symbol": "00700",
  "pageindex": 1,
  "pagesize": 10,
  "language": "en",
  "sortorder": "desc",
  "reporttype": "annual",
  "year": 2025
}

返回契约

HTTP 200：业务码 100 成功。
application/json

{
  "type": "object",
  "required": [
    "DataStatus",
    "Data"
  ],
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码。"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明。"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间。"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算。"
        }
      }
    },
    "Data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "Symbol": {
            "type": "string",
            "description": "港股股票代码。"
          },
          "StockName": {
            "type": "string",
            "description": "港股股票名称。"
          },
          "Title": {
            "type": "string",
            "description": "公告标题。"
          },
          "ShortText": {
            "type": "string",
            "description": "公告摘要或公告分类文本。"
          },
          "LongText": {
            "type": "string",
            "description": "公告详情文本。"
          },
          "FileSize": {
            "type": "string",
            "description": "公告文件大小。"
          },
          "FileType": {
            "type": "string",
            "description": "公告文件类型，例如 PDF。"
          },
          "FileLink": {
            "type": "string",
            "description": "公告文件下载链接。"
          },
          "BulletinDateTime": {
            "type": "string",
            "description": "公告发布时间，格式 yyyy/MM/dd HH:mm。"
          },
          "UniqueId": {
            "type": "string",
            "description": "公告唯一标识。"
          }
        },
        "required": [
          "Symbol",
          "StockName",
          "Title",
          "ShortText",
          "LongText",
          "FileSize",
          "FileType",
          "FileLink",
          "BulletinDateTime",
          "UniqueId"
        ],
        "description": "公告对象数组；合法越界页返回空列表并保留正式筛选总数。"
      },
      "description": "公告对象数组；合法越界页返回空列表并保留正式筛选总数。"
    }
  }
}

HTTP 401：公共鉴权失败；沿用现有公共契约。

HTTP 403：公共权益或额度不足；沿用现有公共契约。

HTTP 404：资源不存在。请求路径不存在。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 405：请求方法不允许。当前路径不支持该 HTTP 方法。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 415：请求内容类型不支持。上传或请求体的内容类型不符合接口要求。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 429：公共频率限制；沿用现有公共契约。

HTTP 502：上游依赖错误。上游依赖服务不可用或返回异常。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 400：业务码 501：参数缺失、非法、重复或冲突。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码。"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明。"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间。"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算。"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "公告对象数组；合法越界页返回空列表并保留正式筛选总数。"
    }
  }
}

HTTP 503：业务码 901：处理、依赖失败或超时。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码。"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明。"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间。"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算。"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "公告对象数组；合法越界页返回空列表并保留正式筛选总数。"
    }
  }
}

业务状态与 HTTP 状态

业务码	含义	说明
100	成功	HTTP 200；仍应检查业务状态。
501	参数错误	HTTP 400
901	依赖失败	HTTP 503

接口详情：https://www.gugudata.com/api/details/stockhkbulletin
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"symbol=00875\u0026pageindex=1\u0026pagesize=10\u0026language=zh\u0026sortorder=desc\u0026reporttype=\u0026year=","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-11-02 17:23:22.523","DataTotalCount":885},"Data":[{"Symbol":"00875","StockName":"從玉智農","Title":"翌日披露報表","ShortText":"翌日披露報表 - [其他]","LongText":"翌日披露報表 - [其他]","FileSize":"125KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/1022/2026102201144_c.pdf","BulletinDateTime":"2026/10/22 18:51","UniqueId":"LSZGNU12380145"},{"Symbol":"00875","StockName":"從玉智農","Title":"完成根據一般授權配售新股份","ShortText":"公告及通告 - [根據一般性授權發行股份 \u0026#x2f; 配售]","LongText":"公告及通告 - [根據一般性授權發行股份 \u0026#x2f; 配售]","FileSize":"194KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/1022/2026102201120_c.pdf","BulletinDateTime":"2026/10/22 18:45","UniqueId":"RYFMTA12380125"},{"Symbol":"00875","StockName":"從玉智農","Title":"截至二零二六年九月三十日止之股份發行人的證券變動月報表","ShortText":"月報表","LongText":"月報表","FileSize":"152KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/1005/2026100501773_c.pdf","BulletinDateTime":"2026/10/05 18:12","UniqueId":"ZGNUBI12361985"},{"Symbol":"00875","StockName":"從玉智農","Title":"二零二六年中期報告","ShortText":"財務報表\u0026#x2f;環境、社會及管治資料 - [中期\u0026#x2f;半年度報告]","LongText":"財務報表\u0026#x2f;環境、社會及管治資料 - [中期\u0026#x2f;半年度報告]","FileSize":"4MB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0929/2026092900733_c.pdf","BulletinDateTime":"2026/09/29 16:59","UniqueId":"DKRYFM12350523"},{"Symbol":"00875","StockName":"從玉智農","Title":"進一步延長根據一般授權配售新股份的最後截止日期","ShortText":"公告及通告 - [配售 \u0026#x2f; 根據一般性授權發行股份]","LongText":"公告及通告 - [配售 \u0026#x2f; 根據一般性授權發行股份]","FileSize":"222KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0928/2026092801426_c.pdf","BulletinDateTime":"2026/09/28 18:38","UniqueId":"QXELSZ12349080"},{"Symbol":"00875","StockName":"從玉智農","Title":"延長根據一般授權配售新股份的最後截止日期","ShortText":"公告及通告 - [配售 \u0026#x2f; 根據一般性授權發行股份]","LongText":"公告及通告 - [配售 \u0026#x2f; 根據一般性授權發行股份]","FileSize":"189KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0907/2026090700986_c.pdf","BulletinDateTime":"2026/09/07 18:41","UniqueId":"PWDKRY12323547"},{"Symbol":"00875","StockName":"從玉智農","Title":"截至二零二六年八月三十一日止之股份發行人的證券變動月報表","ShortText":"月報表","LongText":"月報表","FileSize":"152KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0902/2026090201630_c.pdf","BulletinDateTime":"2026/09/02 17:31","UniqueId":"IPWDKR12316234"},{"Symbol":"00875","StockName":"從玉智農","Title":"截至二零二六年六月三十日止六個月之\n中期業績公佈","ShortText":"公告及通告 - [中期業績]","LongText":"公告及通告 - [中期業績]","FileSize":"581KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0831/2026083102846_c.pdf","BulletinDateTime":"2026/08/31 22:28","UniqueId":"IPWDKR12309838"},{"Symbol":"00875","StockName":"從玉智農","Title":"盈利警告","ShortText":"公告及通告 - [盈利警告 \u0026#x2f; 內幕消息]","LongText":"公告及通告 - [盈利警告 \u0026#x2f; 內幕消息]","FileSize":"195KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0828/2026082801979_c.pdf","BulletinDateTime":"2026/08/28 19:28","UniqueId":"MTAHOV12305604"},{"Symbol":"00875","StockName":"從玉智農","Title":"董事會召開日期","ShortText":"公告及通告 - [董事會召開日期]","LongText":"公告及通告 - [董事會召開日期]","FileSize":"144KB","FileType":"PDF","FileLink":"https://www1.hkexnews.hk/listedco/listconews/sehk/2026/0818/2026081800314_c.pdf","BulletinDateTime":"2026/08/18 16:31","UniqueId":"QXELSZ12287928"}]}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

🔴503业务码 901：处理、依赖失败或超时。

业务说明#

请求参数#

独立请求示例#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

请求参数

独立请求示例

返回契约

业务状态与 HTTP 状态