---
document_id: agent.dataset.tmall
schema_version: 1
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Tmall Monthly Product Sales / 天猫商品月度销量明细表 (`tmall`)

Runtime tenant access and time coverage come only from authenticated `describe(dataset)`.
租户实际权限和时间范围只以认证后的 `describe(dataset)` 为准。

- Platform → dataset → API ID / 平台 → 数据集 → API ID: Tmall / 天猫 → Tmall Monthly Product Sales / 天猫商品月度销量明细表 → `dataset=tmall`
- Time grain / 时间粒度: `month`
- Entity types / 实体类型: `product, shop`
- Filter fields / 可筛选字段: `product_id, shop_id, brand, category_l1, category_l2, category_l3, shop, is_live, has_bybt, bc_type`

## Dimensions / 维度

- `product_id` — Tmall product ID / 天猫商品 ID (filterable; exact-only; references: tmall_product_id, tmall_product_url)
- `title` — Product title (output only; title search is unsupported) / 商品标题（仅支持返回，不支持按标题搜索） (groupable)
- `product_url` — Canonical Tmall product URL / 标准天猫商品链接 (groupable)
- `shop_id` — Tmall shop ID / 天猫店铺 ID (filterable; exact-only; references: tmall_shop_id, tmall_shop_url)
- `shop_url` — Tmall shop URL / 天猫店铺链接 (groupable)
- `brand` — Brand name / 品牌名 (filterable; searchable)
- `category_l1` — Level-1 category / 一级品类 (filterable; searchable)
- `category_l2` — Level-2 category / 二级品类 (filterable; searchable)
- `category_l3` — Level-3 category / 三级品类 (filterable; searchable)
- `shop` — Shop name / 店铺名 (filterable; searchable)
- `month` — Month / 月份 (groupable)
- `is_live` — Whether the product has appeared in live commerce; NULL or empty is unknown, not no. / 商品是否上过直播；NULL 或空字符串表示未知，不表示否 (filterable; exact-only)
- `has_bybt` — Whether the product participates in the RMB 10B subsidy program; NULL or empty is unknown, not no. / 是否参加百亿补贴；NULL 或空字符串表示未知，不表示否 (filterable; exact-only)
- `bc_type` — B/C shop type; NULL or empty is unknown. / 天猫店铺 B/C 类标识；NULL 或空字符串统一表示未知 (filterable; searchable)

## Metrics / 指标

- `gmv` [certified] — Post-coupon sales amount / 券后销售额
- `units` — Units sold / 销量
- `asp` — Average selling price / 平均成交价

## Tasks / 任务

- [`aggregate_drilldown`](/docs/agent/datasets/tmall/tasks/aggregate_drilldown.md) — Query an aggregate scope, then rank products under exactly the same filters. / 先查询汇总范围，再在完全相同的筛选条件下对商品下钻排序。
- [`bc_shop_comparison`](/docs/agent/datasets/tmall/tasks/bc_shop_comparison.md) — Compare monthly atomic sales metrics across normalized B/C shop groups. / 按归一化后的 B/C 店铺分组比较月度原子销售指标。
- [`brand_share`](/docs/agent/datasets/tmall/tasks/brand_share.md) — Compute a brand's share from two atomic GMV results returned by one bundled call. / 通过一次组合调用返回的两个原子销售额结果计算品牌份额。
- [`brand_trend`](/docs/agent/datasets/tmall/tasks/brand_trend.md) — Query monthly atomic metrics for one exact brand. / 查询一个精确品牌的月度原子指标。
- [`bybt_coverage`](/docs/agent/datasets/tmall/tasks/bybt_coverage.md) — Inspect monthly atomic sales metrics grouped by the normalized subsidy indicator. / 按归一化后的百亿补贴标识分组查看月度原子销售指标。
- [`category_product_ranking`](/docs/agent/datasets/tmall/tasks/category_product_ranking.md) — Rank exact product IDs within a resolved category and time range. / 在已对齐的品类和时间范围内对精确商品 ID 排名。
- [`cross_period_products`](/docs/agent/datasets/tmall/tasks/cross_period_products.md) — Compare product-ID sets returned by one bundled period call. / 比较一次组合调用返回的两个期间商品 ID 集合。
- [`live_sales_comparison`](/docs/agent/datasets/tmall/tasks/live_sales_comparison.md) — Compare monthly atomic sales metrics by the normalized live-commerce indicator. / 按归一化后的直播标识比较月度原子销售指标。
- [`product_comparison`](/docs/agent/datasets/tmall/tasks/product_comparison.md) — Compare multiple exact Tmall product references over one time range. / 在同一时间范围内比较多个精确天猫商品引用。
- [`product_contribution`](/docs/agent/datasets/tmall/tasks/product_contribution.md) — Attribute cross-period GMV change from two product-level atomic queries. / 通过两次商品级原子查询归因跨期销售额变化。
- [`product_performance`](/docs/agent/datasets/tmall/tasks/product_performance.md) — Query monthly sales metrics for one exact Tmall product reference. / 查询一个精确天猫商品引用的月度销售指标。
- [`shop_name_performance`](/docs/agent/datasets/tmall/tasks/shop_name_performance.md) — Resolve one spoken shop name and query its monthly atomic metrics. / 对齐一个口语店铺名并查询月度原子指标。
- [`shop_performance`](/docs/agent/datasets/tmall/tasks/shop_performance.md) — Query monthly atomic metrics for one exact Tmall shop ID or standard URL. / 按精确天猫店铺 ID 或标准链接查询月度原子指标。

## Limitations / 限制

- Only monthly-grain data is available; 2026-06 is the first published waterline, not a subscription start month. / 仅支持月粒度数据；2026-06 是首发水位，不是订阅起始月份
- Products and shops require exact IDs or confirmed HTTPS Taobao links. / 商品和店铺只支持精确 ID 或已确认的 HTTPS 淘宝链接格式
- NULL and empty strings consistently mean unknown, not no. / NULL 和空字符串统一表示未知，不等同于否