ESG（ESG 数据）

此类接口提供公司的 ESG 评级信息，包括按公司查询评级、同业之间的基准比较，以及按 ESG 条件反向筛选标的。适合把可持续性因素写进选股或风控规则；覆盖范围取决于 FMP 采用的评级来源，中小市值公司缺失较多，正式用于决策前应先确认目标标的是否有数据。

典型使用场景

4 个场景

可持续投资筛选

按 ESG 得分做初筛，再结合财务指标构建组合。

同业对照

把公司得分放进行业基准分布，判断相对位置。

披露合规研究

检索公司 ESG 相关文件，核对自述与评级差异。

分项差异研究

分别观察 E/S/G 披露得分及风险等级，不将两个接口的结果当作同一种评分。

接口怎么选？

3 项选型对照

ESG 类别回答“这家公司的可持续表现如何、在同行里处于什么位置、有哪些相关披露”。先明确要的是评分、原始披露还是基准对比，再选接口。

ESG 没有统一口径：不同评级机构的方法论、覆盖范围和更新频率差异很大，跨机构的分数不可直接比较；对外引用前先确认评级来源与口径。

你的需求	推荐接口	选择理由
查看公司 ESG 风险等级与行业排名	ESG RatingsESG评级查询	读取 ESGRiskRating、industryRank，并保留 fiscalYear 核对报告口径
取得 E/S/G 分项、综合得分和披露来源	ESG Investment SearchESG投资检索	从 esg-disclosures 读取 environmentalScore、socialScore、governanceScore、ESGScore 及披露信息
与行业或基准做对比	ESG Benchmark ComparisonESG基准对比	把单一公司得分放到同业分布里看

数据覆盖与参数口径

适用对象：以美股为主，海外标的覆盖明显不完整
数据来源：第三方评级机构与公司自主披露，两者口径不同
报告时点：风险等级核对 fiscalYear；披露得分核对 date 和原始披露，不假设两者为同一时点
可比性：跨机构分数不可直接比较，只能同机构同版本内比较
缺失处理：空数组表示当前请求没有可用记录，先核对代码、接口和覆盖范围，不能当 0 分
返回内容：esg-ratings 返回风险等级与排名；esg-disclosures 返回 E/S/G 分项与综合得分；行业基准用于同口径比较
入库口径：保留 symbol、报告期间和披露来源；等级、披露得分与行业基准分开存储，修订数据保留版本

调用示例

Python 关键代码

示例场景：提取公司披露中的 E/S/G 分项与综合得分 · 对应接口：ESG Investment Search（ESG投资检索）

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

resp = requests.get(
    "https://quote-fmp.com/stable/esg-disclosures",
    params={"symbol": "AAPL", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
if not df.empty:
    result = df.reindex(columns=['symbol', 'date', 'environmentalScore', 'socialScore', 'governanceScore', 'ESGScore'])
    for column in ['environmentalScore', 'socialScore', 'governanceScore', 'ESGScore']:
        result[column] = pd.to_numeric(result[column], errors='coerce')
    print(result)

缺失得分不能当 0 分处理。
分项得分、综合得分与风险等级不是同一种输出，比较前核对方法和报告期间。

数据注意事项

4 条实盘要点

将 ESG Ratings（ESG评级查询）返回的评级年度 date、CIK 与分项得分（environmentalScore、socialScore、governanceScore、ESGScore）一并落库保存。
评估公司在所属行业的相对水平时，配合 ESG Benchmark Comparison（ESG基准对比）按 year 获取各行业 ESG 基准均值与评级分布。
按风险等级或争议度反向筛选标的池可使用 ESG Investment Search（ESG投资检索），再与基本面财务因子叠加过滤。
ESG 数据随年报与可持续发展报告按季/按年更新，且中小市值或非美公司常返回空数组，工程上严禁将空数组默认转为 0 分。

常见问题

4 个问题

ESG 评分可以跨机构比较吗？

不建议。各机构方法论、权重与覆盖范围不同，同一家公司拿到的分数可能差别很大，只能在同机构同版本内比较。

为什么查询返回空数组？

先核对 symbol、所选接口及覆盖范围。风险等级和披露得分的可用记录可能不同；空结果不能填成 0 分，也不能仅凭另一接口有数据就断言该接口必有记录。

如何判断两条 ESG 数据能否比较？

核对报告期间、评分方法及数据来源。风险等级记录的 fiscalYear 和披露得分记录的 date 不可直接当成同一时间轴；不要把最新评级回填为过去已知信息。

E/S/G 分项得分在哪里取得，与风险评级有什么区别？

本地样例中，ESG Investment Search（ESG投资检索，实际端点 esg-disclosures）返回 environmentalScore、socialScore、governanceScore 与 ESGScore；ESG Ratings（ESG评级查询）返回 ESGRiskRating、industryRank。总分算法不能由一次响应反推，也不能用风险等级代替综合得分；行业基准比较同样需要核对报告期间与方法。