GateData.AI

业务分部

查询各业务分部经营数据。

GET/api/v1/fundamentals/business-segments
数据域
公司基本面
解析层级
上市公司实体
MCP 工具
fundamentals_query (task=segments)

可查询数据

返回数据
指定上市公司分产品或地区的收入及占比
市场覆盖
美股、港股
查询粒度
每次查询一家公司，按该公司自身业务划分

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

公司定位

建议填写 query、symbol 或 ticker；留空时接口返回 no_data。

querystringquery示例AAPL可选

查询关键词、代码或名称。

symbolstringquery示例AAPL可选

资产代码。

tickerstringquery示例AAPL可选

资产代码。

查询选项

均为可选。

marketMarketquery示例us_equity可选

标准市场代码。

limitintegerquery示例20可选

返回条数。

响应

dataobject
segments[]object[]

分部行：segment_type、segment_name、segment_revenue、share_pct

segment_typestring示例product

分部类型

segment_namestring示例Mac ®

分部名称

segment_revenuenumber | null示例8399000100

分部收入

share_pctnumber | null示例0.075541

收入占比

period_keystring示例FY2026Q2

报告期键

entity_idstring示例entity_sec_cik_0000320193

主体标识，标识公司、项目方或协议等主体

currencystring示例USD

货币

unitstring | null示例actual

单位

data_statusDataStatus示例ok

行级就绪状态

empty_reasonstring | null

行级空原因

data_statusDataStatus示例ok

ok / partial / no_data / not_ready / stale

empty_reasonstring | null

空结果或部分缺失原因码

errorobject | null

错误对象（code / message）。

metadataobject
actual_taskstring示例segments

实际路由任务：profile / statements / metrics / …

data_statusDataStatus示例ok

ok / partial / no_data / not_ready / stale

limitations[]string[]示例serving_mvp

覆盖 / MVP 限制标记

route_reasonstring示例explicit_task

路由原因（如 explicit_task）

updated_atdatetime | string示例2026-08-17T08:25:07Z

响应更新时间（UTC）

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例entity

对象引用类型

idstring示例entity_sec_cik_0000320193

对象标识，标识 type 指定的具体对象

entity_idstring示例entity_sec_cik_0000320193

主体标识，标识公司、项目方或协议等主体

asset_idstring示例asset_aapl_common_stock

资产标识，标识股票、加密资产等资产对象

listing_idstring示例listing_aapl_xnas

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring示例instrument_aapl_common_stock

交易工具标识，标识股票、现货交易对或合约等具体交易产品

venue_idstring示例venue_xnas

交易场所标识，标识交易所或交易平台

external_refs[]object[]

外部引用（如 SEC EDGAR filings）

lineage_refs[]object[]

血缘引用（公开体通常为空数组）

source_refs[]object[]

数据来源引用（公开体通常为空数组）

错误与降级

200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。