证券搜索 API | GroundAPI

概览

GET /v1/finance/search 在已同步的本地全量列表中做关键词匹配（名称或代码子串，不区分大小写）。type 指定搜索哪一类实体；all 时可能在同一响应中返回多类结果。

覆盖规模（约）

类型	条数
A 股股票	6,104
概念	2,222
行业	1,466
ETF	1,377
指数	613
合计	11,780

请求参数

参数	类型	必填	默认值	说明
`keyword`	string	是	-	搜索关键词，至少 1 个字符
`type`	string	否	`all`	`stock` / `concept` / `sector` / `etf` / `index` / `all`
`limit`	int	否	`20`	每一类型最多返回条数（1–100）

请求示例

全类型（all）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=消费&type=all&limit=10"

仅股票（stock）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=茅台&type=stock&limit=5"

概念（concept）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=人工智能&type=concept&limit=15"

行业（sector）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=半导体&type=sector&limit=15"

ETF（etf）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=300&type=etf&limit=10"

指数（index）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=红利&type=index&limit=10"

查询串写法说明

下述表格中的查询示例在 MDX 中对 & 写作 &，与 URL 中实际字符一致；在 curl 命令行中请使用 & 连接参数。

场景	查询示例
全类型搜索	`?keyword=消费&type=all&limit=10`
仅股票	`?keyword=茅台&type=stock&limit=5`

返回示例

type=all（多类有命中时）

data 为对象，键为类型名，值为该类型下的结果数组（无命中类型可省略）。各类型字段名与数据源一致（股票、ETF、指数等常见为 dm/mc；行业板块节点常见为 name/code）。

{
  "success": true,
  "data": {
    "stock": [
      { "dm": "000858", "mc": "五粮液", "jys": "sz" }
    ],
    "concept": [
      { "dm": "885971", "mc": "消费电子概念" }
    ],
    "sector": [
      { "name": "半导体", "code": "881121" }
    ],
    "etf": [
      { "dm": "159928", "mc": "消费ETF", "jys": "sz" }
    ]
  }
}

type=stock

{
  "success": true,
  "data": {
    "stock": [
      { "dm": "600519", "mc": "贵州茅台", "jys": "sh" }
    ]
  }
}

type=index

{
  "success": true,
  "data": {
    "index": [
      { "dm": "000015.SH", "mc": "红利指数" }
    ]
  }
}

定价

$0.02/次。每月前 500 次免费。