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

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

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

Runtime tenant access and time coverage come only from authenticated `describe(dataset)`.
租户实际权限和时间范围只以认证后的 `describe(dataset)` 为准。

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

## Dimensions / 维度

- `product_id` — JD product ID / 京东商品 ID (filterable; exact-only; references: jd_product_id, jd_product_url)
- `title` — Product title (output only; title search is unsupported) / 商品标题（仅支持返回，不支持按标题搜索） (groupable)
- `product_url` — Canonical JD product URL / 标准京东商品链接 (groupable)
- `shop_id` — JD shop ID / 京东店铺 ID (filterable; exact-only; references: jd_shop_id, jd_shop_url)
- `shop_url` — JD shop URL / 京东店铺链接 (groupable)
- `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` [certified] — Post-coupon sales amount / 券后销售额
- `units` — Units sold / 销量
- `asp` — Average selling price / 平均成交价

## Tasks / 任务

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