4.1 销售量数据接口 - getSalesVolume

优质

小牛编辑

137浏览

2023-12-01

销售量数据接口 - getSalesVolume

获取某个品类的销售量状况

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	响应动作
sales_volume	array	时间序列列表,每项参数可见下面 Response Item
total_count	int	根据过滤条件得到的结果集数量

Response Item

Parameter name	Type	Description
time	string	数据纵轴: `year`: 2015, `month`:2015-03月，`quarter`：2015Q1, `week`:2015-03-23
sales_volume	int	销售量
annulus_growth	double	环比增长率
yearonyear_growth	double	同比增长率

示例

请求示例

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

响应示例

{
    "code": 1000,
    "msg": "OK",
    "data": {
        "action": "getSalesVolume",
        "sales_volume": [
            {
                "time": "2014-05月",
                "sales_volume": "308213",
                "annulus_growth": "61.38",
                "yearonyear_growth": "-"
            },
            {
                "time": "2014-06月",
                "sales_volume": "457611",
                "annulus_growth": "48.47",
                "yearonyear_growth": "-"    
            },
            ...
        ],
        "total_count": 12
    }
}