1. 接口描述 #

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

2. 输入参数 #

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

3. 输出参数 #

4. 数据结构 #

4.1 RequestltemFilters #

4.2 RequestBaseMetrics #

4.3 ResponseDataOfItemMetric #

4.3.1 ItemMetric #

5. 示例 #

示例1 查看商品的销售数据详情 #

查看某个商品在某个时间段内的销售数据。

输入示例

{
    "appkey": "predeploy",
    "filters": {
        "crawlerDate": {
            "end": 1649952000000,
            "start": 1640966400000
        },
        "filterSkuIds": [
            100000200000000155,
            100000200000000068,
            100000200000000163,
            100000200000000377,
            100000200000000248,
            100000200000091584,
            100000200000091718,
            100000200000092159,
            100000200000092537,
            100000200000092582,
            100000200000093892
        ]
    },
    "metrics": {
        "dimensions": [
            "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": [
            {
                "metricDate": "2022-01-01",
                "monthSalePrice": 562.6999999999999,
                "monthSaleCnt": 7543,
                "monthSaleAmount": 4244446.1
            },
            {
                "metricDate": "2022-02-01",
                "monthSalePrice": 640.6999999999999,
                "monthSaleCnt": 5566,
                "monthSaleAmount": 3566136.1999999997
            },
            {
                "metricDate": "2022-04-01",
                "monthSalePrice": 716.1213333333333,
                "monthSaleCnt": 4998,
                "monthSaleAmount": 3579174.4239999996
            },
            {
                "metricDate": "2022-03-01",
                "monthSalePrice": 730.7209090909091,
                "monthSaleCnt": 4936,
                "monthSaleAmount": 3606838.407272727
            }
        ],
        "pageSize": 5,
        "page": 1,
        "total": 4,
        "time": 187
    }
}

6. 状态码 #

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