4.6 单品Top10接口 - getTop10Skus

优质

小牛编辑

125浏览

2023-12-01

单品top10数据接口 - GetTop10Skus

获取某个品类的份额前十单品

Request Parameters

Parameter name	Type	Description	Required
category_id	string	品类id	Yes
platform_id	string	平台id，如果为空，则不做过滤	No
brand_id	string	品牌id，如果为空，则不做过滤	No
product_id	int	SKU单品id,如果为空,则不做过滤	No
time_type	string	汇总标准: `Year`,`Quarter`,`Month`,`Week`，如果不提供，默认为`Month`	No
start_time	查询时间段起始时间，格式为时间字符串或者unix时间戳	查询开始时间，如果不提供，则根据结束时间与汇总类型进行计算	No
end_time	请求串生成时间，格式为时间字符串或者unix时间戳	查询截止时间，如果不提供，默认当天	No

Response Elements

Parameter name	Type	Description
action	string	响应动作
skus	array	单品序列,每项参数可见下面 Response Item

Response Item

Parameter name	Type	Description
sku_id	int	SKU编号
name	string	SKU名称
value	double	销售额
percentage	double	市场份额

示例

请求示例

http://open.syntun.cn/api/dq/GetTop10Skus
&category_id=325
&COMMON_PARAMS

响应示例

{
    "code": 1000,
    "msg": "OK",
    "data": {
        "action": "getTop10Skus",
        "skus": [
            {
                "name": "3M CDW7101V 净水机",
                "sku_id": 203151,
                "value": 5376427.21,
                "percentage": 1.17
            },
            {
                "name": "3M DWS 2500-CN 净水机",
                "sku_id": 221496,
                "value": 4370444.33,
                "percentage": 0.95
            },
            ...
        ],
        "total_count": 10
    }
}