4.5 品牌Top10接口 - getTop10Brands

优质

小牛编辑

131浏览

2023-12-01

品牌top10数据接口 - GetTop10Brands

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

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	响应动作
brands	array	品牌序列,每项参数可见下面 Response Item

Response Item

Parameter name	Type	Description
brand_id	int	品牌编号
name	string	品牌名称
value	double	销售额
percentage	double	市场份额

示例

请求示例

http://open.syntun.cn/dq/GetTop10Brands
&category_id=315
&COMMON_PARAMS

响应示例

{
    "code": 1000,
    "msg": "OK",
    "data": {
        "action": "getTop10Brands",
        "brands": [
            {
                "name": "格力",
                "brand_id": 4556,
                "value": 47480668.23,
                "percentage": 22.38
            },
            {
                "name": "海尔",
                "brand_id": 4402,
                "value": 29477073.71,
                "percentage": 13.89
            },
            ...
        ],
        "total_count": 10
    }
}