公告/财报候选链接搜索

公告/财报候选链接搜索。

HTTP 方法与路径：GET /api/v1/stock/report/search

入参

Path

| 路径参数 | 无 |

Query

参数	类型	必填	说明
`code`	string	是	股票代码
`category`	string	是	中文类，可 `;` 多值
`year`	string	否
`limit`	number	否
`keyword`	string	否
`timeRange`	string	否
`stockName`	string	否
`item`	string	否

响应

响应外壳：成功时 JSON 含 success、data、可选 message，见统一响应体。

响应示例

对应请求 GET /api/v1/stock/report/search?code=600887&category=年报。字段以线上为准。


{
  "success": true,
  "data": {
    "code": "600887",
    "timeRange": "3y",
    "category": "年报",
    "requestedCategories": "年报",
    "requestedCategoryKeys": "category_ndbg_szsh",
    "effectiveCategoryParam": "category_ndbg_szsh;",
    "total": 3,
    "candidates": [
      {
        "title": "内蒙古伊利实业集团股份有限公司2024年年度报告",
        "url": "https://static.cninfo.com.cn/finalpage/2025-04-30/1223421123.PDF",
        "publishedAt": "2025-04-29",
        "year": "2024",
        "category": "年报"
      },
      "..."
    ]
  }
}

请求示例


curl -sS -H "Authorization: Bearer <API_KEY>" "http://localhost:4000/api/v1/stock/report/search?code=600887&category=年报"