Revenue Geographic Segments分地区营收

Q: 调用 /stable/revenue-geographic-segmentation 获取分地区营收，怎样根据参数特性控制单次返回的记录范围？

针对 分地区营收（/stable/revenue-geographic-segmentation），请在 /stable/revenue-geographic-segmentation 中区分年度（annual）与单季（quarter）拉取；提取 data（{"Americas Segment": 1783530…）与 symbol 后即可完成当期截面对齐。

该接口按年度或季度拆解上市公司在不同国家与地理区域的营业收入构成（如美洲、欧洲、大中华区、亚太），用于评估海外市场敞口、地缘贸易依赖与汇率敏感度。

GEThttps://quote-fmp.com/stable/revenue-geographic-segmentation?symbol=AAPL

数据更新周期

Filing Date · 随 SEC 申报日期更新

接口说明

区域营收分析：按地理区域拆解营收贡献,看清哪些地区在驱动增长，传入 symbol 后可调取 symbol（证券代码）、fiscalYear（财政年度）与 period（报告周期）等核心数值，方便与本地历史研究库按主键对齐。
市场表现洞察：分析公司在美洲、欧洲、大中华区等关键地区的表现，读取 fiscalYear（财政年度）与 period（报告周期）等结构化数值后，可直接对接估值模型或风控阈值检查。
全球战略规划：对企业而言，理解营收的地理分布有助于制定区域策略、发现新的扩张机会，当单一端点维度不足时，可结合「分产品营收」拼装出更全面的分析视图。
配套投研接口：Cashflow Statement Growth（现金流量表增长数据） · Financial Statement Growth（报表增长分析） · Stock Price and Volume Data（日线完整行情） · Financial Estimates（分析师预期查询）

请求参数

3 个参数

参数	类型	要求	示例	说明
`symbol`	string	必填	`AAPL`	美国 SEC 监管申报或美股上市公司股票代码，例如 AAPL、MSFT、NVDA（仅覆盖美股及在美上市 ADR，无需附加交易所后缀）。
`period`	string	可选	`annual,quarter`	报告周期：annual（年度）、quarter（季度）、ttm（滚动十二个月）（单值枚举：常规报表传 annual 或 quarter，Bulk 传 Q1..Q4 或 FY；每次仅传单值）
`structure`	string	可选	`flat`	SEC 文件的结构化类型，如 Financials、Notes 等。

调用代码示例

Python 关键代码

分地区营收（/stable/revenue-geographic-segmentation）内含动态嵌套字典（含 data（返回数据集合）、symbol（证券代码）、fiscalYear（财政年度）），通过 pd.json_normalize(resp.json()) 可自动展平内层科目。

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

resp = requests.get(
    "https://quote-fmp.com/stable/revenue-geographic-segmentation",
    params={"symbol": "AAPL", "period": "annual", "structure": "flat", "apikey": FMP_KEY},
    timeout=20,
)
resp.raise_for_status()
df = pd.json_normalize(resp.json())
df = df.sort_values("date").reset_index(drop=True)

参数使用和避坑

3 组参数组合 · 2 条避坑

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

投研场景	Query 参数组合示例	返回数据特征与用途
获取 AAPL 历年年度分地区营收序列（period=annual）	`symbol=AAPL&period=annual`	指定年度参数 period=annual 访问 /stable/revenue-geographic-segmentation，拉回 AAPL 历年 data、symbol、fiscalYear（如 {"Americas Segment": 1783530…）。
提取 AAPL 单季分地区营收变动（period=quarter）	`symbol=AAPL&period=quarter`	切换 period=quarter 请求 /stable/revenue-geographic-segmentation，拉回 AAPL 各季度的 data、symbol、fiscalYear 明细。
非美标的 0700.HK 年度分地区营收对标	`symbol=0700.HK&period=annual`	改传 0700.HK 调用 /stable/revenue-geographic-segmentation，拉取非美上市公司的 data、symbol、fiscalYear（核对 reportedCurrency）。

时序与查询边界执行分地区营收查询：data 滚动计算前的升序排列

执行 /stable/revenue-geographic-segmentation 拉取分地区营收（必填 symbol），响应涵盖 data（{"Americas Segment": 1783530…）等 6 列；对返回序列做滚动窗口计算前请先按日期升序排列。

落库主键与口径解析分地区营收：fiscalYear 精度与 (symbol, date, fiscalYear) 唯一键

/stable/revenue-geographic-segmentation 产出的 6 项字段（含 fiscalYear=2025）在写入宽表前，应按 (symbol, date, fiscalYear) 执行去重校验。

返回数据

11 个字段

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

字段	类型	示例值	说明
`symbol`	string	`"AAPL"`	证券代码
`fiscalYear`	number	`2025`	财政年度
`period`	string	`"FY"`	报告周期
`reportedCurrency`	string	`"USD"`	报告币种（原始财报计价币种；跨国公司对比或与美元市值相除前须先按汇率折算）
`date`	string	`"2025-09-27"`	日期
`data`	object	`{…}`	地理区域分部营收明细字典（动态键名随公司实际披露的销售大区/国家变化，值为对应财期营收金额，下方已展开本示例内全部 5 个地区分部键）
`data.Americas Segment`	number	`178353000000`	示例地区分部：美洲地区营业收入（动态键名随公司实际披露的销售大区或国家变化）
`data.Europe Segment`	number	`111032000000`	示例地区分部：欧洲地区营业收入（动态键名随公司实际披露的销售大区或国家变化）
`data.Greater China Segment`	number	`64377000000`	示例地区分部：大中华区营业收入（动态键名随公司实际披露的销售大区或国家变化）
`data.Japan Segment`	number	`28703000000`	示例地区分部：日本地区营业收入（动态键名随公司实际披露的销售大区或国家变化）
`data.Rest of Asia Pacific Segment`	number	`33696000000`	示例地区分部：亚太其他地区营业收入（动态键名随公司实际披露的销售大区或国家变化）

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

[
{
"symbol": "AAPL",
"fiscalYear": 2025,
"period": "FY",
"reportedCurrency": "USD",
"date": "2025-09-27",
"data": {
"Americas Segment": 178353000000,
"Europe Segment": 111032000000,
"Greater China Segment": 64377000000,
"Japan Segment": 28703000000,
"Rest of Asia Pacific Segment": 33696000000
}
}
]

常见问题解答（FAQ）

2 个问题

分地区营收与分产品营收的端点路径（/stable/revenue-geographic-segmentation vs /stable/revenue-product-segmentation）和参数约束分别是怎样的？

调用 /stable/revenue-geographic-segmentation 获取分地区营收时（必填 symbol），您将拿到 data={"Americas Segment": 1783530… 等 6 列数据；而调用 Revenue Product Segmentation（分产品营收）则会拿到 6 列数据。

调用 /stable/revenue-geographic-segmentation 获取分地区营收，怎样根据参数特性控制单次返回的记录范围？

针对分地区营收（/stable/revenue-geographic-segmentation），请在 /stable/revenue-geographic-segmentation 中区分年度（annual）与单季（quarter）拉取；提取 data（{"Americas Segment": 1783530…）与 symbol 后即可完成当期截面对齐。

同模块相关接口对比

Segmentation

本接口路径 /stable/revenue-geographic-segmentation，必填参数 symbol。同一模块「Segmentation」下共 2 个接口，下表列出其余 1 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
分产品营收Revenue Product Segmentation	`/stable/revenue-product-segmentation`	按年度或季度拆解上市公司各产品线与核心业务分部的营业收入构成明细

Statements（财务报表）全部接口目录 →

需要稳定访问分地区营收数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月