拼多多商品月度销量明细表

拼多多 → 拼多多商品月度销量明细表 → dataset=pdd

文档 ID: agent.dataset.pdd

租户实际范围和当前数据时间以认证后的运行时工具及每次查询响应为准。

查询能力

时间粒度: month
实体类型: productshop
可筛选字段: product_idshop_idbrandcategory_l1category_l2category_l3shop
可搜索取值字段: brandcategory_l1category_l2category_l3shop
精确引用格式: —

最小调用

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

query_metrics

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

Credit 消耗价格

正在读取当前价格；页面不会使用备用价格。

查询模式

aggregate_drilldown

汇总与商品下钻

先查询品类汇总，再在相同筛选条件下对商品排名。

brand_share

品牌份额

通过两个原子销售额结果计算品牌份额。

category_product_ranking

品类商品排名

在已对齐的品类内对商品 ID 排名。

shop_name_performance

按店铺名查询销售表现

对齐店铺名并查询月度指标。

字段与能力

product_ididentifier: 拼多多商品的稳定标识，计划用于精确筛选，并与 product_url 对应。
aggregate-select · group-by · aggregate-filter=eq,in
titleattribute: 该自然月记录的商品标题；计划用于返回展示，不用于标题搜索。
aggregate-select · group-by · requires-group-by=product_id
product_urlattribute: 拼多多上游记录提供的商品详情页链接，与 product_id 对应。
aggregate-select · group-by · requires-group-by=product_id
shop_ididentifier: 拼多多店铺的稳定标识，计划用于精确筛选；当前没有可配套的已验证 shop_url。
aggregate-select · group-by · aggregate-filter=eq,in
branddimension: 拼多多上游记录的品牌名称；当前源数据未提供与之对应的 brand_id。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l1dimension: 拼多多上游品类体系中的一级品类名称；当前源数据未提供 category_l1_id。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l2dimension: 拼多多上游品类体系中的二级品类名称；当前源数据未提供 category_l2_id。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l3dimension: 拼多多上游品类体系中的三级品类名称；当前源数据未提供 category_l3_id。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
shopdimension: 拼多多记录的店铺名称，与 shop_id 对应；名称可能随时间变化。
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
monthtime: 商品销售记录所属自然月，格式为 YYYY-MM；计划的数据集粒度为月。
aggregate-select · group-by
gmvmeasure: 计划提供的销售额指标；币种、优惠处理和聚合规则须在运行时启用前确认。
aggregate-select
unitsmeasure: 计划提供的销量指标；源值属于月增量还是累计值，须在运行时启用前确认。
aggregate-select
aspmeasure: 计划提供的加权平均成交价；计算公式和币种须在运行时启用前确认。
aggregate-select

暂不可用字段

brand_idunavailable: 对外提供 brand 时需要配套 brand_id，但当前拼多多源数据未提供品牌标识。
category_l1_idunavailable: 对外提供 category_l1 时需要配套 category_l1_id，但当前拼多多源数据未提供品类标识。
category_l2_idunavailable: 对外提供 category_l2 时需要配套 category_l2_id，但当前拼多多源数据未提供品类标识。
category_l3_idunavailable: 对外提供 category_l3 时需要配套 category_l3_id，但当前拼多多源数据未提供品类标识。
shop_urlunavailable: 对外提供 shop_id 时需要配套 shop_url，但当前拼多多源数据未提供已验证的标准店铺链接。
specificationunavailable: 当前拼多多源数据缺少必要的商品规格属性；product_intro 不等同于 specification，因此不做错误映射。

限制

仅支持月粒度数据
商品筛选仅支持精确 product_id，不支持名称、别名或模糊搜索
店铺可使用精确 shop_id 或经 search_values 对齐后的店铺名
不提供评价、流量、库存、因果解释或其他平台数据
同比、环比、份额、贡献度和跨期集合差异由 Agent 基于原子查询结果计算
指标口径、覆盖量级、更新时间和访问授权仍待上游确认
当前仅含 2026-06 单月数据