1. 接口描述 #

接口URL：https://open.datastory.com.cn/api/datastory.ecommerce.item.trend.metric
请求方式：POST
描述：通过该接口可查看趋势销售数据详情，具体输出内容可查看输出参数示例。

2. 输入参数 #

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

3. 输出参数 #

4. 数据结构 #

4.1 RequestTrendMetricsFilters #

4.2 RequestTrendMetrics #

4.3 ResponseDataOfTrendltemMetric #

4.3.1 TrendItemMetricVO #

5. 示例 #

输入示例

{
  "appkey": "predeploy",
  "filters": {
    "crawlerDate": {
      "end": 1668503100000,
      "start": 1640966400000
    },
    "printLog": true,
    "siteId": 10,
    "spCategoryNames": [
      "3C数码",
      "美妆个护"
    ],
    "trendNames": [
      "修护"
    ]
  },
  "metrics": {
    "categoryLevel": 5,
    "dimensions": [
      "date",
      "siteName"
    ],
    "filterOtherCategoryLevel": true,
    "interval": "month",
    "order": "desc",
    "sort": "date"
  },
  "openStrategy": false,
  "page": 1,
  "pageSize": 20
}

输出示例

{
  "success": true,
  "openStrategy": false,
  "code": 0,
  "msg": "接口返回成功！",
  "data": {
    "meta": {
      "datasetType": "list"
    },
    "dataset": [
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-10",
        "monthSalePrice": 242.8716,
        "monthSaleCnt": 10735827,
        "monthSaleAmount": 2872533278.8638,
        "perPieceSalePrice": 267.5652,
        "maxSalePrice": 17000,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 0.4821,
        "monthSaleAmountRateLp": 1.3283,
        "itemCnt": 41379
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-09",
        "monthSalePrice": 243.3684,
        "monthSaleCnt": 7243578,
        "monthSaleAmount": 1233743422.894,
        "perPieceSalePrice": 170.3224,
        "maxSalePrice": 44990,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 2.5165,
        "monthSaleAmountRateLp": 2.0118,
        "itemCnt": 40968
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-08",
        "monthSalePrice": 260.2417,
        "monthSaleCnt": 2059889,
        "monthSaleAmount": 409626451.0417,
        "perPieceSalePrice": 198.8585,
        "maxSalePrice": 44990,
        "minSalePrice": 1.15,
        "monthSaleCntRateLp": -0.5697,
        "monthSaleAmountRateLp": -0.556,
        "itemCnt": 30629
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-07",
        "monthSalePrice": 256.9328,
        "monthSaleCnt": 4786868,
        "monthSaleAmount": 922697306.9306,
        "perPieceSalePrice": 192.756,
        "maxSalePrice": 19200,
        "minSalePrice": 1.15,
        "monthSaleCntRateLp": -0.4984,
        "monthSaleAmountRateLp": -0.6232,
        "itemCnt": 30927
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-06",
        "monthSalePrice": 238.9538,
        "monthSaleCnt": 9543663,
        "monthSaleAmount": 2448935494.0088,
        "perPieceSalePrice": 256.6033,
        "maxSalePrice": 18700,
        "minSalePrice": 1.15,
        "monthSaleCntRateLp": 0.0786,
        "monthSaleAmountRateLp": 0.0545,
        "itemCnt": 36277
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-05",
        "monthSalePrice": 227.592,
        "monthSaleCnt": 8848276,
        "monthSaleAmount": 2322278624.9703,
        "perPieceSalePrice": 262.4555,
        "maxSalePrice": 17000,
        "minSalePrice": 1.1,
        "monthSaleCntRateLp": 0.616,
        "monthSaleAmountRateLp": 1.44,
        "itemCnt": 39551
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-04",
        "monthSalePrice": 236.6559,
        "monthSaleCnt": 5473358,
        "monthSaleAmount": 951735671.6035,
        "perPieceSalePrice": 173.8851,
        "maxSalePrice": 37223.3333,
        "minSalePrice": 1.15,
        "monthSaleCntRateLp": -0.3138,
        "monthSaleAmountRateLp": -0.4246,
        "itemCnt": 45262
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-03",
        "monthSalePrice": 237.1927,
        "monthSaleCnt": 7976086,
        "monthSaleAmount": 1654135072.1299,
        "perPieceSalePrice": 207.3868,
        "maxSalePrice": 37223.3333,
        "minSalePrice": 1.15,
        "monthSaleCntRateLp": 0.3497,
        "monthSaleAmountRateLp": 0.3878,
        "itemCnt": 42424
      },
      {
        "siteId": 10,
        "siteName": "天猫",
        "metricDate": "2022-02",
        "monthSalePrice": 262.5214,
        "monthSaleCnt": 5914302,
        "monthSaleAmount": 1192164174.7026,
        "perPieceSalePrice": 201.5731,
        "maxSalePrice": 17000,
        "minSalePrice": 1.2,
        "monthSaleCntRateLp": 0.08,
        "monthSaleAmountRateLp": 0.0024,
        "itemCnt": 22201
      }
    ],
    "pageSize": 20,
    "page": 1,
    "total": 9,
    "time": 794
  }
}

6. 状态码 #

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