Friends Data API独立数据服务

DECISION MODEL DATA · 宏观、统计与监管

BEA

美国 GDP、收入与消费统计及估计版本。

API 调用说明

能回答的问题

  • 同一季度 GDP 的初值与修订值有什么差异?
  • 个人收入和消费变动是多少?

状态与已知缺口

部分可用

已有部分发布指标和 GDP/GDI 历史工作簿;不同估计阶段单独保留。

  • 工作簿历史不证明每个数值在当时已经可获取。
  • 未覆盖 BEA 全部统计产品。
  • 指定季度初值的独立原始文档记录暂不提供逐行读取;估计表仍保留不同阶段。

提供方

PRODUCT

BEA GDP 发布估计表

bea_gdp_estimates

每行是一个发布指标,advance、second、third 分别保留不同估计阶段,不能混用。

粒度
每指标每发布快照一行
时间范围
2026-Q2 ~ 2026-Q2 · reference_period_literal 参考季度
采集时间
2026-10-04T07:55:50.538068Z ~ 2026-10-04T07:55:50.538068Z
记录数
8

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=bea_gdp_estimates&limit=100

字段表 · 5 个字段

字段名中文说明
advance初次估计数值
measure统计指标名称
reference_period_literal提供方原始参考期间文本
second第二次估计数值
third第三次估计数值

PRODUCT

BEA GDP / GDI 历史工作簿

bea_gdp_gdi_workbook

每行保留历史工作簿的一个原始行及单元格,工作表区分不同指标与版本。

粒度
每工作表原始行一行
时间范围
2002-Q1 ~ 2026-Q2 · quarter_literal 及原始工作簿表头
采集时间
2026-10-06T05:00:24.027299Z ~ 2026-10-06T05:00:24.027299Z
记录数
1,474

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=bea_gdp_gdi_workbook&limit=100

字段表 · 4 个字段

字段名中文说明
native_cells原始单元格数组,包含位置、值、类型及可用格式信息
quarter_literal原始季度标签
row_number原始工作表行号
sheet原始工作表名称

PRODUCT

BEA 收入与消费月度变动

bea_income_pce_changes

每行是一个收入或消费指标,分别保留报告中的两个月变动百分比。

粒度
每指标每发布快照一行
时间范围
2026-08 ~ 2026-08 · reference_period_literal 参考月份
采集时间
2026-10-04T07:55:50.656868Z ~ 2026-10-04T12:02:36.005383Z
记录数
90

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=bea_income_pce_changes&limit=100

字段表 · 4 个字段

字段名中文说明
august_change_percent8 月变动百分比
july_change_percent7 月变动百分比
measure统计指标名称
reference_period_literal提供方原始参考期间文本

数据观测时间 2026-10-06T17:38:47.854586Z