天猫商品月度销量明细表

查询能力

时间粒度

month

实体类型

productshop

可筛选字段

product_idshop_idbrandcategory_l1category_l2category_l3shopis_livehas_bybtbc_type

可搜索取值字段

brandcategory_l1category_l2category_l3shopbc_type

精确引用格式

tmall_product_idtmall_product_urltmall_shop_idtmall_shop_url

最小调用

这是一个可执行的请求结构；请按用户问题调整范围。

{
  "dataset": "tmall",
  "group_by": [
    "brand"
  ],
  "limit": 10,
  "metrics": [
    "gmv"
  ],
  "order_by": [
    {
      "dir": "desc",
      "field": "gmv"
    }
  ],
  "task_query": "查看天猫最近一个完整月的品牌销售额排名",
  "time": {
    "last_complete_months": 1
  }
}

字段与能力

product_ididentifier

天猫商品的稳定标识，用于精确筛选，并与 product_url 对应。
aggregate-select · group-by · aggregate-filter=eq,in · detail-return · detail-filter=eq,in

titleattribute

该自然月记录的商品标题；可返回展示，但不支持按标题搜索或筛选。
aggregate-select · group-by · detail-return · requires-group-by=product_id

product_urlattribute

根据 product_id 生成的标准天猫商品详情页链接。
aggregate-select · group-by · detail-return · requires-group-by=product_id

shop_ididentifier

天猫店铺的稳定标识，用于精确筛选，并与 shop_url 对应。
aggregate-select · group-by · aggregate-filter=eq,in · detail-return · detail-filter=eq,in

shop_urlattribute

根据 shop_id 生成的标准天猫店铺页面链接。
aggregate-select · group-by · detail-return · requires-group-by=shop_id

brand_ididentifier

天猫上游提供的品牌标识，与 brand 对应；上游未识别品牌时可能为空。
detail-return · detail-filter=eq,in

branddimension

天猫上游记录的品牌名称，与 brand_id 对应；可能为空，也可能存在名称写法差异。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · detail-return · detail-filter=eq,neq,in,not_in,contains · search

category_l1_ididentifier

天猫上游品类体系中 category_l1 对应的一级品类标识；可能为空。
detail-return · detail-filter=eq,in

category_l1dimension

天猫上游品类体系中的一级品类名称，与 category_l1_id 对应。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · detail-return · detail-filter=eq,neq,in,not_in,contains · search

category_l2_ididentifier

天猫上游品类体系中 category_l2 对应的二级品类标识；可能为空。
detail-return · detail-filter=eq,in

category_l2dimension

天猫上游品类体系中的二级品类名称，与 category_l2_id 对应。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · detail-return · detail-filter=eq,neq,in,not_in,contains · search

category_l3_ididentifier

天猫上游品类体系中 category_l3 对应的三级品类标识；可能为空。
detail-return · detail-filter=eq,in

category_l3dimension

天猫上游品类体系中的三级品类名称，与 category_l3_id 对应。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · detail-return · detail-filter=eq,neq,in,not_in,contains · search

shopdimension

天猫记录的店铺名称，与 shop_id 对应；名称可能随时间变化。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · detail-return · detail-filter=eq,neq,in,not_in,contains · search

specificationattribute

商品规格属性集合，通常编码为 JSON 对象字符串；属性键因品类而异，内容可能为空，仅支持明细返回。
detail-return

monthtime

商品销售记录所属自然月，格式为 YYYY-MM；该数据集为月粒度。
aggregate-select · group-by · detail-return

is_livedimension

商品是否上过直播；指记录月份内是否出现在天猫直播场景；空值或空字符串表示未知，不表示否。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,is_unknown,is_known · detail-return · detail-filter=eq,neq,in,not_in,is_unknown,is_known

has_bybtdimension

商品是否参加百亿补贴；指记录月份内是否参加天猫百亿补贴；空值或空字符串表示未知，不表示否。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,is_unknown,is_known · detail-return · detail-filter=eq,neq,in,not_in,is_unknown,is_known

bc_typedimension

天猫店铺 B/C 类标识；去除空白后使用，空值表示店铺类型未知。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,is_unknown,is_known · detail-return · detail-filter=eq,neq,in,not_in,is_unknown,is_known · search

gmvmeasure

券后销售额，单位为人民币元；聚合查询返回所选范围合计，明细查询返回单条商品月记录的金额。
aggregate-select · detail-return · certified

unitsmeasure

商品销量；聚合查询返回所选范围合计，明细查询返回单条商品月记录的销量。
aggregate-select · detail-return

aspmeasure

加权平均成交价，单位为人民币元，按 SUM(gmv) / SUM(units) 计算；总销量为 0 时返回空，仅支持聚合查询。
aggregate-select

限制

• 仅支持月粒度数据；2026-06 是首发水位，不是订阅起始月份
• 商品和店铺只支持精确 ID 或已确认的 HTTPS 淘宝链接格式
• NULL 和空字符串统一表示未知，不等同于否