Securities Search API

Overview

GET /v1/finance/search provides a single search entry point over the unified A-share universe (11,780 searchable securities and related entities in aggregate coverage: listed stocks, ETFs, indices, and taxonomy nodes for concepts and sectors). Results are substring matches on name or code fields, grouped by asset type. Use type to search one category or all (default) to return every matching bucket in one response.

Request Parameters

Parameter	Type	Required	Default	Description
`keyword`	string	Yes	—	Non-empty query; matched case-insensitively inside names and codes.
`type`	string	No	`all`	Restrict to one channel: `stock`, `concept`, `sector`, `etf`, `index`, or `all` for every channel.
`limit`	int	No	`20`	Maximum rows per type when that type is included (1–100).

Coverage (at a glance)

Channel	What you match	Typical fields in each hit
`stock`	A-share listed names / codes	e.g. display code `dm`, name `mc`, exchange hints
`concept`	Thematic / concept indices	concept name `mc`, code `dm`
`sector`	Industry tree leaf nodes	`name`, `code`
`etf`	Exchange-traded funds	fund name `mc`, code `dm`
`index`	Benchmark indices	index name `mc`, code `dm`

The 11,780 figure reflects the full searchable surface across these lists used by the API (stocks, ETFs, indices, and sector/concept taxonomies).

Request Examples

Search everything matching a keyword

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

Stocks only

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

ETFs only

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

Indices only

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=科创&amp;type=index"

Concepts

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/search?keyword=芯片&amp;type=concept&amp;limit=25"

Response Examples

[object Object] (only non-empty buckets are present)

{
  "success": true,
  "data": {
    "stock": [
      { "dm": "600519", "mc": "贵州茅台", "jys": "sh" }
    ],
    "concept": [
      { "dm": "885934", "mc": "消费电子" }
    ],
    "etf": [],
    "index": [
      { "dm": "000688", "mc": "科创50", "jys": "sh" }
    ]
  }
}

[object Object]

{
  "success": true,
  "data": {
    "stock": [
      { "dm": "000858", "mc": "五粮液", "jys": "sz" }
    ]
  }
}

Pricing

$0.02/call. First 500 calls/month are free.