ESG Benchmark ComparisonESG基准对比
该接口用于比较公司与基金的 ESG（环境、社会、治理）表现，可找出行业内的 ESG 领先者与落后者，为负责任的投资决策提供依据。
https://quote-fmp.com/stable/esg-benchmark数据更新周期
N/A · 不适用固定周期
接口说明
- 识别 ESG 领先者：通过与行业同业对比，找到 ESG 表现突出的公司与基金，调用后可输出
sector（板块）、environmentalScore（环境（E）得分）与socialScore（社会（S）得分） 等结构化字段，省去繁琐的网页抓取与文本清洗。 - 发现 ESG 落后者：找出 ESG 表现落后的公司，帮助你决定资金投向，围绕
environmentalScore（环境（E）得分）与socialScore（社会（S）得分） 等字段，可在回测中还原历史任意时点的真实截面。 - 跟踪 ESG 改善：关注 ESG 评级明显提升的公司，捕捉积极变化带来的潜在投资机会，若需补充上下文维度，可搭配同模块的「ESG评级查询」交叉比对核心指标。
- 关联数据线接口：Executive Compensation（高管薪酬查询） · Financial Scores（财务健康评分） · Stock Screener（条件选股） · Company Profile Data（公司概况）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
year | string | 可选 | 2023 | 目标财报/数据的年份，如 2023。 |
调用代码示例
Python 关键代码针对ESG基准对比，向 /stable/esg-benchmark 传入可选 year后，响应提供 sector（板块）、environmentalScore（环境（E）得分）、socialScore（社会（S）得分）（样本 sector=APPAREL RETAIL）。
resp = requests.get(
"https://quote-fmp.com/stable/esg-benchmark",
params={"year": "2023", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 environmentalScore（环境（E）得分）
df["environmentalScore"] = pd.to_numeric(df["environmentalScore"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取 2024 财年ESG基准对比统计截面 | year=2024 | 指定 year=2024 调用 /stable/esg-benchmark，获取该年度的 sector、environmentalScore、socialScore（样本 sector=APPAREL RETAIL）。 |
| 回溯 2023 财年ESG基准对比历史变动 | year=2023 | 将 year 切换为 2023 请求 /stable/esg-benchmark，纵向比对 sector、environmentalScore、socialScore 的跨年变化。 |
ESG基准对比端点 /stable/esg-benchmark（可选 year）单次返回 sector 等 6 项属性；在自动化脚本中建议先校验返回列表长度再提取字段。
在本地数据仓库归档ESG基准对比时，以 (fiscalYear, sector) 去重可防止重跑产生脏数据；其中 environmentalScore（环境（E）得分，如 61.36）为原始未缩写数值。
返回数据
6 个字段本接口示例响应共包含 6 个字段（数值型 5 个，文本/日期/布尔型 1 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
fiscalYear | number | 2023 | 财政年度 |
sector | string | "APPAREL RETAIL" | 板块 |
environmentalScore | number | 61.36 | 环境（E）得分 |
socialScore | number | 67.44 | 社会（S）得分 |
governanceScore | number | 68.1 | 治理（G）得分 |
ESGScore | number | 65.63 | ESG 综合评分 |
查看响应数据示例（原始 JSON）
[
{
"fiscalYear": 2023,
"sector": "APPAREL RETAIL",
"environmentalScore": 61.36,
"socialScore": 67.44,
"governanceScore": 68.1,
"ESGScore": 65.63
}
]常见问题解答（FAQ）
2 个问题想拉取「Esg」相关数据，应该调ESG基准对比（/stable/esg-benchmark）还是 ESG投资检索？
ESG基准对比 对应路径 /stable/esg-benchmark（可选 year），涵盖 sector（APPAREL RETAIL）、environmentalScore（61.36）等 6 列；ESG Investment Search（ESG投资检索） 对应 /stable/esg-disclosures（必填 symbol，共 11 列）。
如何基于 /stable/esg-benchmark 构建稳定的ESG基准对比定时采集与历史补数任务？
回填或同步 ESG基准对比 时，请按 year 过滤条件请求 /stable/esg-benchmark 并做非空校验；对返回的 sector（板块）序列，建议先做排序核对再参与计算。
同模块相关接口对比
Esg本接口路径 /stable/esg-benchmark，无必填参数。 同一模块「Esg」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。