Analyst Ratings Search分析师评级搜索

Q: 分析师评级搜索（/stable/tipranks-search）相比同模块的 个股时点评级，在查询维度与字段上差在哪？

分析师评级搜索 走 /stable/tipranks-search 端点（免业务参数），单条含 recommendationDate、expertUID、analystName 共 13 项字段；同模块的 Point in time Ratings by Symbol（个股时点评级） 走 /stable/tipranks-pit-symbol（必填 symbol，16 项字段）。

该接口提供卖方分析师个股评级记录的多维检索能力，支持按股票代码、分析师标识与日期区间筛选每一条评级结论、目标价、评级调整动作、研报来源及分析师所属券商，并支持切换原币种与汇率折算目标价，适合构建卖方预期修正因子。

GEThttps://quote-fmp.com/stable/tipranks-search

数据更新周期

该接口暂无固定更新周期（多为按需更新的参考或静态数据）。

接口说明

分析师身份：每条结果给出分析师姓名、所属券商和稳定的 expertUID，可传入时点接口，调用后可读取 recommendationDate（投资建议日期）、expertUID（分析师唯一标识）与 analystName（分析师姓名）等标准记录，帮助开发团队快速搭建数据管道。
评级与动作：评级本身（买入/持有/卖出）及所采取的动作——例如首评、上调、下调或维持，基于 Point-in-Time 时点快照还原华尔街投行与明星分析师的历史评级轨迹。
目标价业务定位：默认换算为统一币种，传入 nonadjusted=true 时返回原币种，适合纳入每日定时同步管道，为策略信号生成与风险监控提供稳定数据支撑。
配套投研接口：Point in time Ratings by Symbol（个股时点评级） · Point in time Ratings by Analyst（分析师时点评级） · Financial Estimates（分析师预期查询） · Price Target Consensus（目标价共识）

调用代码示例

Python 关键代码

示例向 /stable/tipranks-search 发起分析师评级搜索请求（仅 apikey），并清洗 recommendationDate（投资建议日期）、expertUID（分析师唯一标识）、analystName（分析师姓名）等核心列。

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/tipranks-search",
    params={"apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 priceTarget（目标价）
df["priceTarget"] = pd.to_numeric(df["priceTarget"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

参数使用和避坑

3 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景	Query 参数组合示例	返回数据特征与用途
一次性拉取全量分析师评级搜索初始化本地主表	`GET /stable/tipranks-search（免参数）`	直接请求 /stable/tipranks-search 即返回全表，含 recommendationDate、expertUID、analystName 等 13 列；建库或每日全量覆盖时无需拼接任何 Query 参数。
以 symbol 为唯一键覆盖写入，避免全表重复	`GET /stable/tipranks-search → upsert on symbol`	全表每轮返回 symbol（样本 RR.L）等 13 列，落库时以 symbol 作唯一键覆盖；同模块无参数相近的接口，单点补数只能重拉全表。
落库后自检：symbol 唯一性与 recommendationDate 空值率	`GET /stable/tipranks-search → count(distinct symbol) / null_ratio(recommendationDate)`	本表共 13 列。落库后先比对 count(distinct symbol) 与总行数确认无重复；再统计 recommendationDate（样本 2026-07-30）的空值比例，判断该批次是否拉到完整截面。

时序与查询边界分析师评级搜索数据集：recommendationDate 与 expertUID 缺失值检测

/stable/tipranks-search 返回的分析师评级搜索数据集（免业务参数）以 recommendationDate（样本 2026-07-30）和 expertUID（样本 9d6962cbd29862b8d70de0a2…）为核心，衍生计算前建议先做缺失值检测。

落库主键与口径管理分析师评级搜索历史表：(symbol, date) 排序键与 priceTarget 原始值

同步 /stable/tipranks-search 的 13 个字段入库时，依赖 (symbol, date) 实现幂等去重；核心数值 priceTarget（如 1500）可直接用于量化回测计算。

返回数据

13 个字段

本接口示例响应共包含 13 个字段（数值型 1 个，文本/日期/布尔型 12 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段	类型	示例值	说明
`symbol`	string	`"RR.L"`	证券代码
`date`	string	`"2026-07-30T16:40:58.403Z"`	日期
`recommendationDate`	string	`"2026-07-30"`	投资建议日期
`expertUID`	string	`"9d6962cbd29862b8d70de0a2ddb3eb…"`	分析师唯一标识
`analystName`	string	`"Ross Law"`	分析师姓名
`firmName`	string	`"Morgan Stanley"`	机构名称
`recommendation`	string	`"buy"`	投资建议
`analystAction`	string	`"maintained"`	分析师评级动作（上调/下调/维持）
`articleTitle`	string	`"Analysts Offer Insights on Ind…"`	文章标题
`articleSite`	string	`"TipRanks Contributor"`	文章来源站
`priceTarget`	number	`1500`	目标价
`priceTargetCurrency`	string	`"GBX"`	目标价计价币种
`url`	string	`"https://www.tipranks.com/news/…"`	链接地址

查看响应数据示例（原始 JSON）

[
{
"symbol": "RR.L",
"date": "2026-07-30T16:40:58.403Z",
"recommendationDate": "2026-07-30",
"expertUID": "9d6962cbd29862b8d70de0a2ddb3eb0bdfedc2b7",
"analystName": "Ross Law",
"firmName": "Morgan Stanley",
"recommendation": "buy",
"analystAction": "maintained",
"articleTitle": "Analysts Offer Insights on Industrial Goods Companies: Rolls-Royce Holdings (Other OTC: RYCEF), Builders Firstsource (NYSE: BLDR) and Canadian Pacific Kansas City (NYSE: CP)",
"articleSite": "TipRanks Contributor",
"priceTarget": 1500,
"priceTargetCurrency": "GBX",
"url": "https://www.tipranks.com/news/blurbs/analysts-offer-insights-on-industrial-goods-companies-rolls-royce-holdings-otherrycef-builders-firstsource-bldr-and-canadian-pacific-kansas-city-cp-blurbs-news"
}
]

常见问题解答（FAQ）

2 个问题

分析师评级搜索（/stable/tipranks-search）相比同模块的个股时点评级，在查询维度与字段上差在哪？

分析师评级搜索走 /stable/tipranks-search 端点（免业务参数），单条含 recommendationDate、expertUID、analystName 共 13 项字段；同模块的 Point in time Ratings by Symbol（个股时点评级）走 /stable/tipranks-pit-symbol（必填 symbol，16 项字段）。

针对 /stable/tipranks-search（分析师评级搜索），工程脚本中如何避免漏数或无效轮询？

生产调度中通常直接请求无参端点 /stable/tipranks-search 拉取全表快照并缓存；每次拉回 recommendationDate（样本 2026-07-30）后，按时间或代码水位线增量推进。

同分类关联接口对比

合作方数据

本接口路径 /stable/tipranks-search（所属子模块「TipRanks Search」仅此 1 个接口），无必填参数。下表列出同属「合作方数据」大类下的 6 个关联接口，方便横向对比与上下游联动：

接口	路径	核心差异与适用场景
个股时点评级Point in time Ratings by Symbol	`/stable/tipranks-pit-symbol`	按股票代码与历史查询日期窗口返回华尔街卖方分析师的时点评级明细
分析师时点评级Point in time Ratings by Analyst	`/stable/tipranks-pit-analyst`	按指定历史截面日期汇总单名卖方分析师对其所覆盖全部股票的最新有效评级与目标价快照
个股评级汇总Ratings Summary by Symbol	`/stable/tipranks-symbol-summary`	按指定日期窗口汇总单只股票收到的全部卖方分析师评级分布与目标价准确度统计
分析师评级汇总Ratings Summary by Analyst	`/stable/tipranks-analyst-summary`	按滚动十二个月或自定义日期窗口汇总单名卖方分析师的全部评级表现
券商评级汇总Ratings Summary by Firm	`/stable/tipranks-firm-summary`	按指定时间窗口汇总单家券商研究所旗下全体分析师的评级与目标价整体战绩
分析师档案查询Analyst Directory Lookup	`/stable/tipranks-analysts`	按分析师英文全名精确检索卖方分析师档案

Partners（合作方数据）全部接口目录 →

需要稳定访问分析师评级搜索数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月