Company Name Search公司名称检索
该接口支持通过公司英文全称、简称或资产名称关键词反向检索全球交易所上市的股票与 ETF 代码。它解决了仅有企业名称而缺失标准交易代码的映射难题,适用于外部资讯实体对齐与跨数据源证券主表建库。
https://quote-fmp.com/stable/search-name?query=AA数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 非结构化文本与实体链接:在处理财经新闻、行业研报或另类数据时,文本中往往仅提及公司商业名称而未标注股票代码。该接口可将企业名称关键词快速映射为标准交易代码,打通文本挖掘与行情回测的关联链路。
- 同一发行人多地挂牌与份额识别:大型跨国企业或 ETF 系列常在多个国家交易所同步挂牌或发行不同币种份额。通过名称检索可一次性列出该主体旗下的全部普通股、存托凭证(ADR)及衍生份额,便于投研人员全局比选流动性最佳标的。
- 代码与名称双引擎搜索架构:当用户不确定股票字母简写时,该接口与代码检索接口共同构成前端智能搜索框的双引擎,优先针对证券名称字段做关键词匹配,显著提升行情终端与投研平台的标的查准率。
- 跨模块关联接口:Company Profile Data(公司概况) · Stock Quote(股票报价) · Income Statement(利润表) · Financial Statement Symbols List(报表公司清单)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
query | string | 必填 | AA | 搜索关键词,按名称或代码匹配返回相关标的。 |
limit | number | 可选 | 50 | 返回结果条数上限,用于控制单次响应大小。 |
exchange | string | 可选 | NASDAQ | 目标交易所代码或名称,如 NASDAQ、NYSE、AMEX。 |
调用代码示例
Python 关键代码通过 /stable/search-name 检索公司名称检索(参数:必填 query),输出 name(名称)、exchangeFullName(交易所全称)、exchange(交易所代码)(示例 name=AAG USD)。
resp = requests.get(
"https://quote-fmp.com/stable/search-name",
params={"query": "AA", "limit": 50, "exchange": "NASDAQ", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 公司名称检索 核心列:symbol, name, currency, exchangeFullName
df = df[["symbol", "name", "currency", "exchangeFullName"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 指定纳斯达克(NASDAQ)拉取公司名称检索 | query=AA&exchange=NASDAQ | 向 /stable/search-name 传 exchange=NASDAQ,获取纳斯达克市场的 name、exchangeFullName、exchange(样本 name=AAG USD)。 |
| 切换纽交所(NYSE)对比公司名称检索 | query=AA&exchange=NYSE | 改传 exchange=NYSE 调用 /stable/search-name,拉取纽交所主板对应的 name、exchangeFullName、exchange。 |
/stable/search-name(必填 query)返回的 name(名称,样本 AAG USD)为当前有效记录;在写入本地维表或缓存前,请先去除首尾空白字符并校验非空。
公司名称检索返回的 name(名称,示例 AAG USD)在增量同步时,应按 (symbol, exchange, name) 覆盖更新已有记录,保证本地维表幂等。
返回数据
5 个字段本接口示例响应共包含 5 个字段(数值型 0 个,文本/日期/布尔型 5 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAGUSD" | 证券代码 |
name | string | "AAG USD" | 名称 |
currency | string | "USD" | 计价币种 |
exchangeFullName | string | "CCC" | 交易所全称 |
exchange | string | "CRYPTO" | 交易所代码 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAGUSD",
"name": "AAG USD",
"currency": "USD",
"exchangeFullName": "CCC",
"exchange": "CRYPTO"
}
]常见问题解答(FAQ)
2 个问题公司名称搜索与股票代码搜索有什么实际区别?
此接口的 query 面向公司名称文本,如 Apple;已知 AAPL 这类代码或代码片段时,可用股票代码检索。名称可能对应多个市场或多种证券,所以要结合 symbol、exchangeFullName 和 currency 确认目标,再进入公司资料或行情查询;返回字段相同不代表搜索输入可以互换。
如何减少搜索结果中的同名歧义和无效调用?
使用目标代码或名称作为 query,按需要设置 exchange 与 limit 缩小候选范围。limit 只控制返回上限,不是历史窗口或分页游标。让用户确认候选的 symbol、交易所和币种后再请求业务数据;不要按时间水位线把搜索结果当作历史序列增量同步。
同模块相关接口对比
Search本接口路径 /stable/search-name,必填参数 query。 同一模块「Search」下共 7 个接口,下表列出其余 6 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 股票代码检索Stock Symbol Search | /stable/search-symbol | 按股票代码前缀或片段在全球多个证券市场中快速检索匹配标的,覆盖美股、国际股票与 ETF |
| CIK 检索Search Cik | /stable/search-cik | 按美国证监会(SEC)中央索引键(CIK)精确反查对应的上市公司档案、股票代码及挂牌交易所 |
| CUSIP 检索CUSIP | /stable/search-cusip | 按北美统一证券识别码(CUSIP)精确查询对应的上市公司名称、交易代码及实时市值 |
| ISIN 检索Search Isin | /stable/search-isin | 按 12 位国际证券识别码(ISIN)精确检索对应的证券名称、股票代码及最新市值 |
| 条件选股Stock Screener | /stable/company-screener | 是面向全市场证券的横截面多条件初筛工具 |
| 多交易所上市检索Exchange Variants | /stable/search-exchange-variants | 查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体 |