PDD Monthly Product Sales

PDD → PDD Monthly Product Sales → dataset=pdd

Document ID: agent.dataset.pdd

Authenticated runtime tools and each query response are authoritative for tenant scope and current data coverage.

Query capabilities

Time grain: month
Entity types: productshop
Filter fields: product_idshop_idbrandcategory_l1category_l2category_l3shop
Searchable value fields: brandcategory_l1category_l2category_l3shop
Exact reference formats: —

Minimal call

This is an executable request shape; adjust its scope to the user's question.

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 consumption pricing

Loading active pricing; this page has no fallback prices.

Query Patterns

aggregate_drilldown

Aggregate and product drilldown

Query a category scope, then rank products under the same filters.

brand_share

Brand share

Compute brand share from two atomic GMV results.

category_product_ranking

Category product ranking

Rank exact product IDs within a resolved category.

shop_name_performance

Shop performance by name

Resolve a shop name and query monthly metrics.

Fields and capabilities

product_ididentifier: Stable PDD product identifier intended for exact filtering and paired with product_url.
aggregate-select · group-by · aggregate-filter=eq,in
titleattribute: Product title recorded for the month; intended for output, not title search.
aggregate-select · group-by · requires-group-by=product_id
product_urlattribute: PDD product-detail URL supplied by the upstream record and paired with product_id.
aggregate-select · group-by · requires-group-by=product_id
shop_ididentifier: Stable PDD shop identifier intended for exact filtering; a verified shop_url is not currently available.
aggregate-select · group-by · aggregate-filter=eq,in
branddimension: Brand name recorded by the upstream PDD data; the current source does not provide a matching brand_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l1dimension: Level-1 category name in the upstream PDD hierarchy; the current source does not provide category_l1_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l2dimension: Level-2 category name in the upstream PDD hierarchy; the current source does not provide category_l2_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l3dimension: Level-3 category name in the upstream PDD hierarchy; the current source does not provide category_l3_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
shopdimension: Shop name recorded by PDD and paired with shop_id; it may change over time.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
monthtime: Calendar month to which the product sales record belongs, formatted as YYYY-MM; the planned dataset grain is monthly.
aggregate-select · group-by
gmvmeasure: Planned sales-amount metric; currency, discount treatment, and aggregation rules must be confirmed before runtime activation.
aggregate-select
unitsmeasure: Planned units-sold metric; whether the source value is monthly incremental or cumulative must be confirmed before runtime activation.
aggregate-select
aspmeasure: Planned weighted average selling price; its formula and currency must be confirmed before runtime activation.
aggregate-select

Known unavailable fields

brand_idunavailable: Required to pair with brand, but the current PDD source does not provide a brand identifier.
category_l1_idunavailable: Required to pair with category_l1, but the current PDD source does not provide category identifiers.
category_l2_idunavailable: Required to pair with category_l2, but the current PDD source does not provide category identifiers.
category_l3_idunavailable: Required to pair with category_l3, but the current PDD source does not provide category identifiers.
shop_urlunavailable: Required to pair with shop_id, but the current PDD source does not provide a verified canonical shop URL.
specificationunavailable: Required product specification attributes are not present in the current PDD source; product_intro is not treated as an equivalent field.

Limitations

Only monthly data is supported.
Product filtering supports exact product_id only; names, aliases, and fuzzy search are not supported.
Shops accept an exact shop_id or a shop name aligned with 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.
Metric definitions, coverage volume, refresh timing, and access entitlement are pending upstream confirmation.
The current release contains only a single 2026-06 month.