---
document_id: agent.dataset.jd
schema_version: 2
parent_document_id: agent.capabilities
section: capabilities
---

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

# JD Monthly Product Sales / 京东商品月度销量明细表

This page defines canonical public field names. Authenticated tools and runtime responses are authoritative for current execution capabilities, tenant access, and time coverage; use `describe(dataset)` only to recover from a contract or capability error.
此页定义 canonical 公共字段名。当前执行能力、租户权限和时间范围以认证后的工具面与运行时响应为准；仅在契约或能力错误后使用 `describe(dataset)` 恢复。

- Platform / 平台: JD / 京东
- API ID: `dataset=jd`
- Time grain / 时间粒度: `month`
- Entity types / 实体类型: `product, shop`
- Filter fields / 可筛选字段: `product_id, shop_id, brand, category_l1, category_l2, category_l3, shop`

## Minimal call / 最小调用

`query_metrics`

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


## Fields and capabilities / 字段与能力

- `product_id` — Stable JD product identifier used for exact filtering and paired with product_url. / 京东商品的稳定标识，用于精确筛选，并与 product_url 对应。 (identifier; detail-return; aggregate-select; group-by; sort; aggregate-filter=eq,in; detail-filter=eq,in; references=jd_product_id,jd_product_url)
- `title` — Product title recorded for the month; available for output, but not for title search or filtering. / 该自然月记录的商品标题；可返回展示，但不支持按标题搜索或筛选。 (attribute; detail-return; aggregate-select; group-by; sort; requires-group-by=product_id)
- `product_url` — Canonical JD product-detail URL generated from product_id. / 根据 product_id 生成的标准京东商品详情页链接。 (attribute; detail-return; aggregate-select; group-by; sort; requires-group-by=product_id)
- `shop_id` — Stable JD shop identifier used for exact filtering and paired with shop_url. / 京东店铺的稳定标识，用于精确筛选，并与 shop_url 对应。 (identifier; detail-return; aggregate-select; group-by; sort; aggregate-filter=eq,in; detail-filter=eq,in; references=jd_shop_id,jd_shop_url)
- `shop_url` — Canonical JD shop-page URL supplied by the upstream record and paired with shop_id; it may be empty. / 京东上游记录提供的标准店铺页面链接，与 shop_id 对应；可能为空。 (attribute; detail-return; aggregate-select; group-by; sort; requires-group-by=shop_id)
- `brand_id` — Upstream JD brand identifier paired with brand; it may be missing when the source does not identify a brand. / 京东上游提供的品牌标识，与 brand 对应；上游未识别品牌时可能为空。 (identifier; detail-return; detail-filter=eq,in)
- `brand` — Brand name recorded by the upstream JD data, paired with brand_id; it may be missing or vary in spelling. / 京东上游记录的品牌名称，与 brand_id 对应；可能为空，也可能存在名称写法差异。 (dimension; detail-return; aggregate-select; group-by; sort; search; aggregate-filter=eq,neq,in,not_in,contains; detail-filter=eq,neq,in,not_in,contains)
- `category_l1_id` — Identifier of category_l1 in the upstream JD category hierarchy; it may be missing. / 京东上游品类体系中 category_l1 对应的一级品类标识；可能为空。 (identifier; detail-return; detail-filter=eq,in)
- `category_l1` — Level-1 category name in the upstream JD hierarchy, paired with category_l1_id. / 京东上游品类体系中的一级品类名称，与 category_l1_id 对应。 (dimension; detail-return; aggregate-select; group-by; sort; search; aggregate-filter=eq,neq,in,not_in,contains; detail-filter=eq,neq,in,not_in,contains)
- `category_l2_id` — Identifier of category_l2 in the upstream JD category hierarchy; it may be missing. / 京东上游品类体系中 category_l2 对应的二级品类标识；可能为空。 (identifier; detail-return; detail-filter=eq,in)
- `category_l2` — Level-2 category name in the upstream JD hierarchy, paired with category_l2_id. / 京东上游品类体系中的二级品类名称，与 category_l2_id 对应。 (dimension; detail-return; aggregate-select; group-by; sort; search; aggregate-filter=eq,neq,in,not_in,contains; detail-filter=eq,neq,in,not_in,contains)
- `category_l3_id` — Identifier of category_l3 in the upstream JD category hierarchy; it may be missing. / 京东上游品类体系中 category_l3 对应的三级品类标识；可能为空。 (identifier; detail-return; detail-filter=eq,in)
- `category_l3` — Level-3 category name in the upstream JD hierarchy, paired with category_l3_id. / 京东上游品类体系中的三级品类名称，与 category_l3_id 对应。 (dimension; detail-return; aggregate-select; group-by; sort; search; aggregate-filter=eq,neq,in,not_in,contains; detail-filter=eq,neq,in,not_in,contains)
- `shop` — Shop name recorded by JD, paired with shop_id; it may change over time. / 京东记录的店铺名称，与 shop_id 对应；名称可能随时间变化。 (dimension; detail-return; aggregate-select; group-by; sort; search; aggregate-filter=eq,neq,in,not_in,contains; detail-filter=eq,neq,in,not_in,contains)
- `specification` — Product specification attributes, usually encoded as a JSON object string; keys vary by category, the value may be empty, and it is available only in detail output. / 商品规格属性集合，通常编码为 JSON 对象字符串；属性键因品类而异，内容可能为空，仅支持明细返回。 (attribute; detail-return)
- `month` — Calendar month to which the product sales record belongs, formatted as YYYY-MM; the dataset grain is monthly. / 商品销售记录所属自然月，格式为 YYYY-MM；该数据集为月粒度。 (time; detail-return; aggregate-select; group-by; sort)
- `gmv` — Post-coupon sales amount in CNY; aggregate queries sum the selected scope, while detail queries return the value for one product-month record. / 券后销售额，单位为人民币元；聚合查询返回所选范围合计，明细查询返回单条商品月记录的金额。 (measure; detail-return; aggregate-select; sort; certified)
- `units` — Units sold; aggregate queries sum the selected scope, while detail queries return the value for one product-month record. / 商品销量；聚合查询返回所选范围合计，明细查询返回单条商品月记录的销量。 (measure; detail-return; aggregate-select; sort)
- `asp` — Weighted average selling price in CNY, calculated as SUM(gmv) / SUM(units); null when total units is zero, and available only in aggregate queries. / 加权平均成交价，单位为人民币元，按 SUM(gmv) / SUM(units) 计算；总销量为 0 时返回空，仅支持聚合查询。 (measure; aggregate-select; sort)

## Query Patterns / 查询模式

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

## Limitations / 限制

- Only monthly-grain data is available. / 仅支持月粒度数据
- Products require an exact product_id or a standard item.jd.com URL; names, aliases, fuzzy search, and short links are unsupported. / 商品仅支持精确 product_id 或标准 item.jd.com 商品链接，不支持名称、别名、模糊搜索或短链
- Shops accept an exact shop_id, a standard mall.jd.com URL, or an exact shop name resolved with search_values. / 店铺可使用精确 shop_id、标准 mall.jd.com 链接或经 search_values 对齐后的店铺名
- Reviews, traffic, inventory, causal explanations, and other platforms are not provided. / 不提供评价、流量、库存、因果解释或其他平台数据
- YoY, MoM, share, contribution, and cross-period set differences must be computed by the Agent from atomic query results. / 同比、环比、份额、贡献度和跨期集合差异由 Agent 基于原子查询结果计算