另类数据商户层级 · REST 接口

商户与母公司、股票代码、行业板块之间的映射参考数据，覆盖 Fable 欧洲消费交易面板。每行代表一个商户及其公司层级与分类元数据。最新每周快照包含约 3500 个商户，覆盖约 250 家美国上市公司。可用 lookup_name 与「商户聚合」接口的 name 字段关联；按指定日期 D 做时点关联时，可用 active_from.lte=D&active_to.gte=D 筛选。active_from 为 0001-01-01 表示起始日期未知，active_to 为 9999-12-31 表示该映射当前仍有效。

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

上游时效说明

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

上游历史范围

数据可追溯至 2021 年 11 月 1 日

适用场景

商户与股票代码映射、公司层级查询、板块与行业分类、时点历史层级分析。

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

查询参数

参数	类型	必填	说明
`lookup_name`	string	No	小写商户标签，用于与商户聚合接口的 name 字段关联（例如 asda、amazon）。
`lookup_name.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`lookup_name.gt`	string	No	筛选大于该值。
`lookup_name.gte`	string	No	筛选大于或等于该值。
`lookup_name.lt`	string	No	筛选小于该值。
`lookup_name.lte`	string	No	筛选小于或等于该值。
`ticker`	string	No	该商户对应的股票代码（已映射约 250 家美国上市公司），采用 Bloomberg 标准。
`ticker.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`ticker.gt`	string	No	筛选大于该值。
`ticker.gte`	string	No	筛选大于或等于该值。
`ticker.lt`	string	No	筛选小于该值。
`ticker.lte`	string	No	筛选小于或等于该值。
`listing_status`	string	No	该商户是上市公司还是非上市公司。可选值：public、private。
`listing_status.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`active_from`	string	No	该商户层级映射的生效日期。取值 0001-01-01 表示起始日期未知。可与 active_to 配合，用于匹配商户聚合接口的 transaction_date，以执行时点查询。值格式须为 yyyy-mm-dd。
`active_from.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`active_from.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`active_from.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`active_from.lte`	string	No	筛选小于或等于该值。值格式须为 yyyy-mm-dd。
`active_to`	string	No	因公司行动导致该商户层级映射不再适用的截止日期。取值 9999-12-31 表示该映射当前有效。值格式须为 yyyy-mm-dd。
`active_to.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`active_to.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`active_to.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`active_to.lte`	string	No	筛选小于或等于该值。值格式须为 yyyy-mm-dd。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 50000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 lookup_name，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].active_from`	string	该商户层级映射的生效日期。取值 0001-01-01 表示起始日期未知。可与 active_to 配合，用于匹配商户聚合接口的 transaction_date，以执行时点查询。
`results[].active_to`	string	因公司行动导致该商户层级映射不再适用的截止日期。取值 9999-12-31 表示该映射当前有效。
`results[].category`	string	数据提供方分配的商户类别（首字母大写，如「Groceries」「General Merchandise」「Travel」）。取值由数据提供方维护，可能随时间扩充。
`results[].grandparent_name`	string	商户上两级母公司的名称（各词首字母大写）。
`results[].grandparent_ticker`	string	商户上两级母公司的股票代码。采用彭博标准。
`results[].great_grandparent_name`	string	商户上三级母公司的名称（各词首字母大写，顶层法人实体）。
`results[].great_grandparent_ticker`	string	商户上三级母公司（顶层法人实体）的股票代码。采用彭博标准。
`results[].industry`	string	基于 GICS/BICS/ICB 标准的行业分类。
`results[].industry_group`	string	基于 GICS/BICS/ICB 标准的行业组分类。
`results[].listing_status`	string	该商户是上市公司还是非上市公司。可选值：public、private。
`results[].lookup_name`	string	小写商户标签，用于与商户聚合接口的 name 字段关联（例如 asda、amazon）。
`results[].normalized_name`	string	经清洗与标准化的商户展示名称（首字母大写，如「Asda」「Amazon」）。
`results[].parent_name`	string	商户的母公司名称（各词首字母大写）。可用于跨子品牌聚合交易。
`results[].parent_ticker`	string	商户母公司的股票代码。采用彭博标准。
`results[].sector`	string	基于 GICS/BICS/ICB 标准的板块分类。
`results[].sub_industry`	string	基于 GICS/BICS/ICB 标准的子行业分类。
`results[].ticker`	string	该商户对应的股票代码（已映射约 250 家美国上市公司），采用 Bloomberg 标准。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": "a1b2c3d4e5f6",
  "results": [
    {
      "active_from": "0001-01-01",
      "active_to": "9999-12-31",
      "category": "General Merchandise",
      "grandparent_name": "Amazon Inc",
      "grandparent_ticker": "AMZN US",
      "great_grandparent_name": "Amazon Inc",
      "great_grandparent_ticker": "AMZN US",
      "industry": "E-Commerce Discretionary",
      "industry_group": "Retail - Discretionary",
      "listing_status": "public",
      "lookup_name": "amazon",
      "normalized_name": "Amazon Inc",
      "parent_name": "Amazon Inc",
      "parent_ticker": "AMZN US",
      "sector": "Consumer Discretionary",
      "sub_industry": "E-Commerce Discretionary",
      "ticker": "AMZN US"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

另类数据 商户层级 · REST 接口

适用场景

查询参数

响应字段

响应示例

另类数据商户层级 · REST 接口