Analyst Directory Lookup分析师档案查询
该接口支持按分析师英文全名精确检索卖方分析师档案，返回其在研究网络中的唯一身份标识、所属券商机构、个人星级评分以及历史推荐胜率、超额收益率、总推荐次数与成功次数等核心战绩指标，用于卖方分析师能力画像与选股胜率溯源。
https://quote-fmp.com/stable/tipranks-analysts数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 稳定标识：其他 TipRanks 接口所需的输入参数
expertUID，调用后可下发expertUID（分析师唯一标识）、analystName（分析师姓名）与firmName（机构名称） 等标准化字段，可无缝接入实盘风控与预警系统。 - 基本信息：分析师所属券商和头像 URL，可直接用于档案页头部，基于 Point-in-Time 时点快照还原华尔街投行与明星分析师的历史评级轨迹。
- 星级评分：TipRanks 根据历史战绩评定的 numOfStars 星级，适合纳入每日定时同步管道，为策略信号生成与风险监控提供稳定数据支撑。
- 跨模块关联接口：Ratings Summary by Symbol（个股评级汇总） · Ratings Summary by Analyst（分析师评级汇总） · Ratings Snapshot（评级快照） · Stock Price and Volume Data（日线完整行情）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
limit | number | 可选 | 1000 | 返回结果条数上限，用于控制单次响应大小。 |
firmName | string | 可选 | Morgan Stanley | 机构名称关键词，用于按机构检索。 |
调用代码示例
Python 关键代码采集 分析师档案查询（/stable/tipranks-analysts）需传可选 page, limit，重点读取 expertUID（分析师唯一标识）、analystName（分析师姓名）、firmName（机构名称）（样本 expertUID=0458d251af4db6d595c17e02…）。
resp = requests.get(
"https://quote-fmp.com/stable/tipranks-analysts",
params={"page": 0, "limit": 1000, "firmName": "Morgan Stanley", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 successRate（成功率）
df["successRate"] = pd.to_numeric(df["successRate"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 读取分析师档案查询最新首屏流（page=0, limit=50） | page=0&limit=50 | 请求 /stable/tipranks-analysts 首屏记录，获取最新披露的 expertUID、analystName、firmName（样本 expertUID=0458d251af4db6d595c17e02…）。 |
| 递增游标翻页回填分析师档案查询（page=1, limit=100） | page=1&limit=100 | 向 /stable/tipranks-analysts 传 page=1&limit=100，向历史纵深翻页归档 expertUID、analystName、firmName 等 9 列。 |
对接 /stable/tipranks-analysts（分析师档案查询，可选 page, limit）时，重点字段 expertUID（0458d251af4db6d595c17e02…）反映最新快照状态，与下游行情或财务表关联前须对齐代码后缀。
清洗分析师档案查询响应时，先按 (expertUID) 剔除重复行，再提取 successRate（成功率，样本 0.617）构造量化指标。
返回数据
9 个字段本接口示例响应共包含 9 个字段（数值型 6 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
expertUID | string | "0458d251af4db6d595c17e02da3bc6…" | 分析师唯一标识 |
analystName | string | "Sujeeva De Silva" | 分析师姓名 |
firmName | string | "Roth MKM" | 机构名称 |
successRate | number | 0.617 | 成功率 |
excessReturn | number | 0.563 | 超额收益 |
totalRecommendations | number | 496 | 评级总数 |
goodRecommendations | number | 306 | 好评级数量 |
analystRank | number | 24 | 分析师排名 |
numOfStars | number | 5 | 星级评分数 |
查看响应数据示例（原始 JSON）
[
{
"expertUID": "0458d251af4db6d595c17e02da3bc6ae4bb093b0",
"analystName": "Sujeeva De Silva",
"firmName": "Roth MKM",
"successRate": 0.617,
"excessReturn": 0.563,
"totalRecommendations": 496,
"goodRecommendations": 306,
"analystRank": 24,
"numOfStars": 5
}
]常见问题解答（FAQ）
2 个问题请求 /stable/tipranks-analysts 获取分析师档案查询时有哪些必填项？它与 分析师评级搜索 的边界在哪？
分析师档案查询（/stable/tipranks-analysts）采用可选 page, limit查询，返回首条样本如 expertUID=0458d251af4db6d595c17e02…（共 9 列）；同模块相邻的 Analyst Ratings Search（分析师评级搜索）则包含 13 列。
初次建库回填分析师档案查询与日常增量拉取 /stable/tipranks-analysts，在传参方式上有何技巧？
在量化管道中，应在 /stable/tipranks-analysts 中固定 limit 并从 page=0 起逐页拉取；若并发拉取多组任务，请结合网关 RPM 配额控制并发协程数，稳健采集 expertUID。
同分类关联接口对比
合作方数据本接口路径 /stable/tipranks-analysts（所属子模块「Tipranks Analysts」仅此 1 个接口），无必填参数。 下表列出同属「合作方数据」大类下的 6 个关联接口，方便横向对比与上下游联动：
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 分析师评级搜索Analyst Ratings Search | /stable/tipranks-search | 卖方分析师个股评级记录的多维检索能力 |
| 个股时点评级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 | 按指定时间窗口汇总单家券商研究所旗下全体分析师的评级与目标价整体战绩 |