4.4 平台Top10接口 - getTop10Platforms

优质

小牛编辑

141浏览

2023-12-01

平台top10数据接口 - GetTop10Platforms

获取某个品类的份额前十平台

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

Response Item

Parameter name	Type	Description
platform_id	int	平台编号
name	string	平台名称
value	double	销售额
percentage	double	市场份额

示例

请求示例

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

响应示例

{
    "code": 1000,
    "msg": "OK",
    "data": {
        "action": "getTop10Platforms",
        "platforms": [
            {
                "name": "天猫",
                "platform_id": 5,
                "value": 69440698.25,
                "percentage": 32.73
            },
            {
                "name": "国美在线",
                "platform_id": 4,
                "value": 49063077.33,
                "percentage": 23.12
            },
            ...
        ],
        "total_count": 8
    }
}