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

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

# PDD Monthly Product Sales / 拼多多商品月度销量明细表 (`pdd`)

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: PDD / 拼多多 → PDD Monthly Product Sales / 拼多多商品月度销量明细表 → `dataset=pdd`
- Time grain / 时间粒度: `month`
- Entity types / 实体类型: `product, shop`
- Filter fields / 可筛选字段: `product_id, shop_id, brand, category_l1, category_l2, category_l3, shop`

## Dimensions / 维度

- `product_id` — PDD product ID / 拼多多商品 ID (filterable; exact-only)
- `title` — Product title (output only) / 商品标题（仅支持返回，不支持按标题搜索） (groupable)
- `product_url` — Canonical PDD product URL / 标准拼多多商品链接 (groupable)
- `shop_id` — PDD 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)
- `shop` — Shop name / 店铺名 (filterable; searchable)
- `month` — Month / 月份 (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/pdd/tasks/aggregate_drilldown.md) — Query a category scope, then rank products under the same filters. / 先查询品类汇总，再在相同筛选条件下对商品排名。
- [`brand_share`](/docs/agent/datasets/pdd/tasks/brand_share.md) — Compute brand share from two atomic GMV results. / 通过两个原子销售额结果计算品牌份额。
- [`category_product_ranking`](/docs/agent/datasets/pdd/tasks/category_product_ranking.md) — Rank exact product IDs within a resolved category. / 在已对齐的品类内对商品 ID 排名。
- [`shop_name_performance`](/docs/agent/datasets/pdd/tasks/shop_name_performance.md) — Resolve a shop name and query monthly metrics. / 对齐店铺名并查询月度指标。

## Limitations / 限制

- Only monthly data is supported. / 仅支持月粒度数据
- Product filtering supports exact product_id only; names, aliases, 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 a single 2026-06 month. / 当前仅含 2026-06 单月数据