Company Search
公司信息
Company Search
Search listed companies by name, ticker or keyword (Chinese/English) and return matching company profiles
POST
Company Search
公司搜索
URL:/v1/stock/company-search
方法: POST描述: 通过公司名称、股票代码或关键词(支持中英文)搜索上市公司,返回最匹配的公司信息列表。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| query | str | 是 | 搜索关键词:公司名称 / 简称 / 股票代码 / 自由文本,如 腾讯、AAPL |
| top_k | int | 否 | 返回的最大公司数量,默认 10 |
| strict | bool | 否 | 是否启用严格关键词匹配,默认 true |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| companies | array | 匹配到的公司列表,按相关度排序。 |
| id | int | 公司 ID。 |
| symbol | str | 完整股票标识,如 HK:00700。 |
| market | str | 市场代码,如 HK / US / SH / SZ。 |
| region | str | 地区代码。 |
| ticker | str | 股票代码,如 00700 / AAPL。 |
| name | str | 公司显示名称。 |
| full_name | str | 公司全称。 |
| chinese_name | str | 中文名称。 |
| chinese_full_name | str | 中文全称。 |
| english_name | str | 英文名称。 |
| english_full_name | str | 英文全称。 |
| synonyms | str | 别名/同义词(逗号分隔)。 |
| logo | str | 公司 Logo 地址。 |
| rank | int | 相关度排序值(越小越靠前)。 |
| words | array | 从查询中抽取的关键词(严格匹配时返回)。 |
请求示例
cURL响应示例
query 为空时返回空列表 {"companies": [], "words": []}。错误响应
| 状态码 | 描述 |
|---|---|
| 403 | 未认证(缺少或无效的 API Key)。 |
| 422 | 请求参数验证失败。 |
Authorizations
Enter your Bearer token
Body
application/json
