ESG Investment SearchESG投资检索

该接口按 ESG 评分、表现、争议情况及业务涉足领域筛选公司与基金,帮助你找到与自身 ESG 价值观一致的投资标的。

GEThttps://quote-fmp.com/stable/esg-disclosures?symbol=AAPL

数据更新周期

1 Hour

接口说明

  • 按 ESG 评分检索:找出 ESG 评级强、符合自己投资标准的公司与基金,传入 symbol 后可拉取 companyName(公司名称)、formType(SEC申报表单类型(如10-K、10-Q、8-K、4、13F))与 environmentalScore(环境(E)得分) 等指标,为基本面与量价研究提供标准输入。
  • 评估 ESG 表现:按 ESG 表现过滤投资标的,确保其符合你的价值观和财务目标,配合 formType(SEC申报表单类型(如10-K、10-Q、8-K、4、13F))与 environmentalScore(环境(E)得分) 等返回项,能高效支撑同行业标的横向比对。
  • 评估争议风险:按争议评分过滤,避开卷入重大 ESG 争议的公司,实务中常与同模块的「ESG评级查询」联合调用,先做广度筛查再下钻单标明细。
  • 上下游关联接口:Financial Scores(财务健康评分) · Stock Screener(条件选股) · Company Profile Data(公司概况) · Executive Compensation(高管薪酬查询)

请求参数

1 个参数
参数类型要求示例说明
symbolstring必填AAPL美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。

调用代码示例

Python 关键代码

从披露记录提取 E/S/G 分项与 ESGScore,保留 symbol 和 date 以核对报告口径;风险等级并非本接口的同一项输出。

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)

参数使用和避坑

2 组参数组合 · 2 条避坑

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

投研场景Query 参数组合示例返回数据特征与用途
传入 symbol=AAPL 请求ESG投资检索symbol=AAPL调用 /stable/esg-disclosures 拉取 AAPL 的ESG投资检索,输出 environmentalScore、socialScore、governanceScore 等 11 项标准化属性。
拉取 NVDA 的ESG投资检索做同业对标symbol=NVDA通过 symbol=NVDA 请求 /stable/esg-disclosures,拉回 ESG投资检索 的 environmentalScore、socialScore、governanceScore 明细数据。
防未来函数ESG投资检索:核验 acceptedDate 的来源,避免将账期或回填时间当作公开时刻

/stable/esg-disclosures 返回 acceptedDate(样本 2026-04-30),但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报,可结合接收时间和时区判断可见性;非美标的、与期末同日的零点时间或回填日期,须先核对原始披露来源。未核实前保留原值,不据此承诺回测已消除前视偏差。

落库主键与口径从 /stable/esg-disclosures 抽取 environmentalScore:(symbol, cik, date) 主键与空值兼容

从 /stable/esg-disclosures 抽取 environmentalScore(样本 66.29)入库时,以 (symbol, cik, date) 建唯一索引可安全支持断点续传。

返回数据

11 个字段

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

字段类型示例值说明
datestring"2026-03-28"日期
acceptedDatestring"2026-04-30"受理日期(SEC 精确到秒接收时间戳;Point-in-Time 量化回测须以此时间为准以防未来函数)
symbolstring"AAPL"证券代码
cikstring"0000320193"SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失)
companyNamestring"Apple Inc."公司名称
formTypestring"8-K"SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F)
environmentalScorenumber66.29环境(E)得分
socialScorenumber45.21社会(S)得分
governanceScorenumber58.87治理(G)得分
ESGScorenumber56.79ESG 综合评分
urlstring"https://www.sec.gov/Archives/e…"链接地址
查看响应数据示例(原始 JSON)
[
{
"date": "2026-03-28",
"acceptedDate": "2026-04-30",
"symbol": "AAPL",
"cik": "0000320193",
"companyName": "Apple Inc.",
"formType": "8-K",
"environmentalScore": 66.29,
"socialScore": 45.21,
"governanceScore": 58.87,
"ESGScore": 56.79,
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000011/0000320193-26-000011-index.htm"
}
]

常见问题解答(FAQ)

2 个问题
ESG 风险等级与 E/S/G 分项得分是同一类结果吗?

不是。本地接口样例中 esg-ratings 返回 ESGRiskRating、industryRank 与 fiscalYear;esg-disclosures 返回 environmentalScore、socialScore、governanceScore、ESGScore 及披露信息。先按需要的是风险等级还是披露得分选择接口;不同方法和报告期的数据不能直接合并成同一种评分。

拉取 /stable/esg-disclosures 的ESG投资检索数据时,如何处理历史回溯、空结果判定或代码格式?

针对 /stable/esg-disclosures,推荐向 /stable/esg-disclosures 传入标准 symbol(港股带 .HK、A 股带 .SS);这样既能稳定获取 environmentalScore(环境(E)得分),又能避免单次请求载荷过大。

同模块相关接口对比

Esg

本接口路径 /stable/esg-disclosures,必填参数 symbol。 同一模块「Esg」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。

接口路径核心差异与适用场景
ESG评级查询ESG Ratings/stable/esg-ratings公司与基金的详细 ESG 评级数据,覆盖环境、社会、治理三个维度并附争议评分
ESG基准对比ESG Benchmark Comparison/stable/esg-benchmark比较公司与基金的 ESG表现,可找出行业内的 ESG 领先者与落后者

ESG(ESG 数据)全部接口目录 →

需要稳定访问 ESG投资检索 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月