1. 接口描述

接口URL：https://open.datastory.com.cn/api/datastory.ecommerce.item.category-metric 请求方式：POST 描述：通过该接口可查看电商商品品类维度数据详情，包括：品牌、自然月销额、自然月销量、自然月售价、站点名、站点ID、商品唯一ID、日期等等，具体输出内容可查看输出参数示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 数据结构

4.1 RequestltemFilters

4.2 RequestBaseMetrics

4.3 ResponseDataOfItemMetric

4.3.1 ItemMetric

5. 示例

示例1 查看品类下的销售数据详情

查看某个品类在某个时间段内的销售数据（时序）。

输入示例

{"appkey": "predeploy",
  "filters": {
    "categoryName":"手机",
    "siteId":10
    },
  "metrics":{
    "dimensions":["date"]
  },  
  "openStrategy": false,
  "page": 1,
  "pageSize": 20
}

输出示例

Download
{
  "success": true,
  "openStrategy": false,
  "code": 0,
  "msg": "接口返回成功！",
  "data": {
    "meta": {
      "datasetType": "aggregation"
    },
    "dataset": [
      {
        "metricDate": "2022-02",
        "monthSalePrice": 7830.8455,
        "monthSaleCnt": 148757959,
        "monthSaleAmount": 13397618051.5614,
        "perPieceSalePrice": 90.0632,
        "maxSalePrice": 9999999,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 0.2112,
        "monthSaleAmountRateLp": 0.0655
      },
      {
        "metricDate": "2022-03",
        "monthSalePrice": 4559.6587,
        "monthSaleCnt": 127687936,
        "monthSaleAmount": 13327233617.7702,
        "perPieceSalePrice": 104.3735,
        "maxSalePrice": 9999999,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": -0.1416,
        "monthSaleAmountRateLp": -0.0052
      },
      {
        "metricDate": "2022-01",
        "monthSalePrice": 2087.5621,
        "monthSaleCnt": 122814595,
        "monthSaleAmount": 12573254053.5233,
        "perPieceSalePrice": 102.3759,
        "maxSalePrice": 9999999,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 0,
        "monthSaleAmountRateLp": 0
      },
      {
        "metricDate": "2022-05",
        "monthSalePrice": 1101.7651,
        "monthSaleCnt": 59707941,
        "monthSaleAmount": 6963857344.7076,
        "perPieceSalePrice": 116.632,
        "maxSalePrice": 9999999,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 0.3532,
        "monthSaleAmountRateLp": 0.3492
      },
      {
        "metricDate": "2022-04",
        "monthSalePrice": 1293.6471,
        "monthSaleCnt": 44123504,
        "monthSaleAmount": 5161401434.8491,
        "perPieceSalePrice": 116.9762,
        "maxSalePrice": 9999999,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": -0.6544,
        "monthSaleAmountRateLp": -0.6127
      },
      {
        "metricDate": "2022-07",
        "monthSalePrice": 1283.8424,
        "monthSaleCnt": 33548673,
        "monthSaleAmount": 6376149364.8165,
        "perPieceSalePrice": 190.0567,
        "maxSalePrice": 145854.7143,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 10.8253,
        "monthSaleAmountRateLp": 0.312
      },
      {
        "metricDate": "2022-06",
        "monthSalePrice": 871.3365,
        "monthSaleCnt": 2837021,
        "monthSaleAmount": 4859851259.1445,
        "perPieceSalePrice": 1713.0121,
        "maxSalePrice": 187599,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": -0.9525,
        "monthSaleAmountRateLp": -0.3021
      }
    ],
    "pageSize": 20,
    "page": 1,
    "total": 7,
    "time": 1243
  }
}

6. 状态码

以下仅列出了接口业务逻辑相关的状态码。