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

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

# Douyin Monthly Product Sales / 抖音商品月度销量明细表 (`douyin`)

This page describes the public contract and static sample; runtime access and time coverage are environment and tenant scoped, so check authenticated `list_datasets` or `describe(dataset)`.
此页提供公开契约和静态样例；运行时访问与覆盖范围以认证后的 `list_datasets` 或 `describe(dataset)` 结果为准。

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

## Dimensions / 维度

- `product_id` — Douyin product ID / 抖音商品 ID (filterable; exact-only; references: douyin_product_id)
- `title` — Product title (output only) / 商品标题（仅支持返回，不支持按标题搜索） (groupable)
- `product_url` — Product URL / 商品链接 (groupable)
- `shop_id` — Douyin shop ID / 抖音店铺 ID (filterable; exact-only)
- `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)
- `category_l4` — Level-4 category / 四级品类 (filterable; searchable)
- `shop` — Shop name / 店铺名 (filterable; searchable)
- `month` — Month / 月份 (groupable)
- `day` — Daily product-detail date within a month-partitioned release / 商品日明细日期；数据按月份分区 (groupable)

## Metrics / 指标

- `gmv` — Sales amount (upstream definition pending) / 销售额（待上游口径确认）
- `units` — Units sold (upstream definition pending) / 销量（待上游口径确认）
- `asp` — Average selling price (upstream definition pending) / 平均成交价（待上游口径确认）

## Tasks / 任务

- [`aggregate_drilldown`](/docs/agent/datasets/douyin/tasks/aggregate_drilldown.md) — Query a category scope, then rank products under the same filters. / 先查询品类汇总，再在相同筛选条件下对商品排名。
- [`brand_share`](/docs/agent/datasets/douyin/tasks/brand_share.md) — Compute brand share from two atomic GMV results. / 通过两个原子销售额结果计算品牌份额。
- [`category_product_ranking`](/docs/agent/datasets/douyin/tasks/category_product_ranking.md) — Rank exact product IDs within a resolved category. / 在已对齐的品类内对商品 ID 排名。
- [`product_performance`](/docs/agent/datasets/douyin/tasks/product_performance.md) — Query daily sales metrics for one exact product within month-partitioned coverage. / 在按月分区的数据范围内，查询一个精确商品的每日销售指标。
- [`shop_name_performance`](/docs/agent/datasets/douyin/tasks/shop_name_performance.md) — Resolve a shop name and query monthly metrics. / 对齐店铺名并查询月度指标。

## Limitations / 限制

- Data is partitioned by calendar month; product detail supports daily queries within a month range. / 数据按自然月分区；商品明细支持在月份范围内按日查询
- Product filtering supports exact product_id only; names, aliases, product URLs, and fuzzy search are not supported. / 商品筛选仅支持精确 product_id，不支持名称、别名、商品链接或模糊搜索
- Shops accept an exact shop_id or a shop name aligned with search_values. / 店铺可使用精确 shop_id 或经 search_values 对齐后的店铺名
- Reviews, traffic, inventory, causal explanations, and other platform data are not provided. / 不提供评价、流量、库存、因果解释或其他平台数据
- YoY, MoM, share, contribution, and cross-period set differences are computed by the Agent from atomic query results. / 同比、环比、份额、贡献度和跨期集合差异由 Agent 基于原子查询结果计算
- Metric definitions, coverage volume, refresh timing, and access entitlement are pending upstream confirmation. / 指标口径、覆盖量级、更新时间和访问授权仍待上游确认
- The current release contains only the first four days of 2026-06 and is incomplete. / 当前仅含 2026-06 前四天数据，数据不完整