1. 接口描述 #

接口URL：https://open.datastory.com.cn/api/datastory.ecommerce.item.brand-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": {
        "brandName": "雅诗兰黛",
        "crawlerDate": {
            "end": 1649952000000,
            "start": 1640966400000
        }
    },
    "metrics": {
        "categoryLevel": 4,
        "dimensions": [
            "categoryName",
            "date"
        ],
        "interval": "month",
        "order": "desc",
        "sort": "monthSaleCnt"
    },
    "openStrategy": false,
    "page": 1,
    "pageSize": 5
}

输出示例

{
  "success": true,
  "openStrategy": false,
  "code": 0,
  "msg": "接口返回成功！",
  "data": {
    "meta": {
      "datasetType": "aggregation"
    },
    "dataset": [
      {
        "fourthCategoryName": "眼霜",
        "metricDate": "2022-03",
        "monthSalePrice": 526.989,
        "monthSaleCnt": 157358,
        "monthSaleAmount": 100070061.6121,
        "perPieceSalePrice": 635.9388,
        "maxSalePrice": 2780,
        "minSalePrice": 5
      },
      {
        "fourthCategoryName": "粉底液",
        "metricDate": "2022-03",
        "monthSalePrice": 376.0687,
        "monthSaleCnt": 143367,
        "monthSaleAmount": 50482661.9364,
        "perPieceSalePrice": 352.1219,
        "maxSalePrice": 920,
        "minSalePrice": 4
      },
      {
        "fourthCategoryName": "粉底液",
        "metricDate": "2022-02",
        "monthSalePrice": 416.5071,
        "monthSaleCnt": 86186,
        "monthSaleAmount": 35587467.45,
        "perPieceSalePrice": 412.9147,
        "maxSalePrice": 920,
        "minSalePrice": 5.8
      },
      {
        "fourthCategoryName": "眼霜",
        "metricDate": "2022-01",
        "monthSalePrice": 770.0414,
        "monthSaleCnt": 82227,
        "monthSaleAmount": 59526457,
        "perPieceSalePrice": 723.9284,
        "maxSalePrice": 2765,
        "minSalePrice": 73.5
      },
      {
        "fourthCategoryName": "眼霜",
        "metricDate": "2022-02",
        "monthSalePrice": 768.6381,
        "monthSaleCnt": 82016,
        "monthSaleAmount": 61004530.0357,
        "perPieceSalePrice": 743.8125,
        "maxSalePrice": 2780,
        "minSalePrice": 9.5
      }
    ],
    "pageSize": 5,
    "page": 1,
    "total": 222,
    "time": 3174
  }
}

6. 状态码 #

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