另类数据商户聚合 · REST 接口

欧洲消费支出聚合数据（数据源为 Fable Data）。可按日跟踪约 250 家美国上市公司在英国、德国、法国、意大利、西班牙、奥地利 6 个欧洲国家的信用卡、借记卡与开放银行交易总额。数据自 2016 年起提供，西班牙自 2019 年起。原始消费总额需先做归一化处理才能准确衡量消费趋势，方法论见 Massive 上游「Normalizing Merchant Aggregates」说明。

GET /consumer-spending/eu/v1/merchant-aggregates

上游时效说明

包含于部分消费支出扩展套餐（每日更新）

上游历史范围

数据可追溯至 2016 年 1 月 1 日

适用场景

消费趋势分析、商户营收估算、跨境消费对比、板块与行业基准比较。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`transaction_date`	string	No	消费者交易发生的日历日期。值格式须为 yyyy-mm-dd。
`transaction_date.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`transaction_date.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`transaction_date.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`transaction_date.lte`	string	No	筛选小于或等于该值。值格式须为 yyyy-mm-dd。
`name`	string	No	该聚合数据对应的商户或实体名称（小写）。当 type 为 merchant 时，可将该值用作商户层级接口的 lookup_name，以获取完整的公司层级信息。
`name.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`name.gt`	string	No	筛选大于该值。
`name.gte`	string	No	筛选大于或等于该值。
`name.lt`	string	No	筛选小于该值。
`name.lte`	string	No	筛选小于或等于该值。
`user_country`	string	No	消费者居住国（ISO 代码）。可用国家：UK、DE、FR、ES、IT、AT；其余取值统一映射为 unknown。
`user_country.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`channel`	string	No	交易渠道。可选值：online、offline、bnpl（先买后付平台，如 Scala、Klarna、Zilch）。
`channel.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`consumer_type`	string	No	该账户所属的样本组。可选值：consumer_credit、consumer_debit、open_banking。
`consumer_type.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`parent_name`	string	No	商户的母公司名称（各词首字母大写）。便于跨子品牌聚合交易；完整的公司结构也可在商户层级接口中获取。
`parent_name.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`parent_name.gt`	string	No	筛选大于该值。
`parent_name.gte`	string	No	筛选大于或等于该值。
`parent_name.lt`	string	No	筛选小于该值。
`parent_name.lte`	string	No	筛选小于或等于该值。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 5000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 transaction_date，排序方向默认为 desc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].channel`	string	交易渠道。可选值：online、offline、bnpl（先买后付平台，如 Scala、Klarna、Zilch）。
`results[].consumer_type`	string	该账户所属的样本组。可选值：consumer_credit、consumer_debit、open_banking。
`results[].eight_day_rolling_category_accounts`	integer	在给定国家与消费者类型下，过去 8 天内在该商户类别（MCC 组）有交易的唯一消费者账户数量。用于短期归一化计算（例如每 1000 名样本用户的消费额 = (total_spend / eight_day_rolling_category_accounts) * 1000）。
`results[].eight_day_rolling_total_accounts`	integer	在给定国家与消费者类型下，过去 8 天内有过任意交易活动（含所有类别）的唯一消费者账户数量。为整体样本规模提供基线。
`results[].mcc_group`	string	与该商户或支付处理方关联的商户类别代码组。
`results[].merchant_industry`	string	基于 GICS/BICS/ICB 数据分类的商户细分行业名称。
`results[].merchant_ticker`	string	与该商户关联的股票代码（已映射约 250 家美国上市公司）。采用 Bloomberg 代码，且为时点数据。
`results[].name`	string	该聚合数据对应的商户或实体名称（小写）。当 type 为 merchant 时，可将该值用作商户层级接口的 lookup_name，以获取完整的公司层级信息。
`results[].parent_name`	string	商户的母公司名称（各词首字母大写）。便于跨子品牌聚合交易；完整的公司结构也可在商户层级接口中获取。
`results[].published_date`	string	该数据版本的发布日期。对于原始数据，约为 transaction_date 之后 7 天。
`results[].spend_in_distinct_account_key_count`	integer	有入账交易的去重账户键（唯一消费者账户）数量。
`results[].spend_in_spend`	number	该聚合数据中，以指定货币计价的入账交易总额（退款、退货、贷记款）。取值为正，表示资金流回消费者账户。
`results[].spend_in_transaction_count`	integer	入账交易笔数（退款、退货）。
`results[].spend_out_distinct_account_key_count`	integer	有出账交易的去重账户键（唯一消费者账户）数量。
`results[].spend_out_spend`	number	该聚合数据中，以指定货币计价的出账交易总额（消费者支出金额）。取值为负，表示资金流出消费者账户。
`results[].spend_out_transaction_count`	integer	出账交易笔数（消费、付款）。
`results[].total_accounts`	integer	该聚合数据中有任意交易活动的去重消费者账户总数。
`results[].total_spend`	number	spend_out_spend 与 spend_in_spend 之和。通常为负（净流出）。取值为正表示该聚合数据中的退款金额超过新增消费。
`results[].total_transactions`	integer	全部交易的总笔数（出账 + 入账）。
`results[].transaction_currency`	string	交易的 ISO 货币代码（卡／账户基础货币）。该数据集恒为 EUR 或 GBP。所有消费金额均以该货币计价。
`results[].transaction_date`	string	消费者交易发生的日历日期。
`results[].twenty_eight_day_rolling_category_accounts`	integer	在给定国家与消费者类型下，过去 28 天内在该商户类别（MCC 组）有交易的唯一消费者账户数量。用于较长期的归一化计算。
`results[].twenty_eight_day_rolling_total_accounts`	integer	在给定国家与消费者类型下，过去 28 天内有过任意交易活动（含所有类别）的唯一消费者账户数量。为整体样本规模提供较长期基线。
`results[].type`	string	聚合类型。可为 merchant 或 payment_processor。
`results[].user_country`	string	消费者居住国（ISO 代码）。可用国家：UK、DE、FR、ES、IT、AT；其余取值统一映射为 unknown。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "request_id": "c38af84c88ba484cb8430ba1511b1f24",
  "results": [
    {
      "channel": "offline",
      "consumer_type": "open_banking",
      "eight_day_rolling_category_accounts": 40346,
      "eight_day_rolling_total_accounts": 463648,
      "mcc_group": "memberships & organizations",
      "merchant_industry": "Leisure Clubs & Facilities",
      "merchant_ticker": "0206472D US",
      "name": "zumba fitness",
      "parent_name": "Zumba Fitness Llc",
      "published_date": "2026-01-25",
      "spend_in_distinct_account_key_count": 0,
      "spend_in_spend": 0,
      "spend_in_transaction_count": 0,
      "spend_out_distinct_account_key_count": 1,
      "spend_out_spend": -3,
      "spend_out_transaction_count": 1,
      "total_accounts": 1,
      "total_spend": -3,
      "total_transactions": 1,
      "transaction_currency": "GBP",
      "transaction_date": "2026-01-18",
      "twenty_eight_day_rolling_category_accounts": 91642,
      "twenty_eight_day_rolling_total_accounts": 524917,
      "type": "merchant",
      "user_country": "UK"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

另类数据 商户聚合 · REST 接口

适用场景

查询参数

响应字段

响应示例

另类数据商户聚合 · REST 接口