畅销商品榜

应用场景

查询指定畅销商品榜榜单信息，每月5号上午9点更新上月数据。包括日期、省份、行业类型、类目名称、商品条码、商品名称、排序方式、排名、排名变化、售价中位数（元）、品牌名称。

请求参数

接口名称: top.products.month.get

参数名称	必填	类型	示例	说明
date	否	String(10)	2020-04-01	yyyy-MM-dd，每月一号，若不填，默认日期为上个月1号（若当天日期为当月1号-5号，则默认为上上个月1号）。最多支持查询近6个月的数据
province_code	是	String(10)	110000	参考省份编码 , 1 表示全国
business_type	否	int	2	行业类型：1.全部,2.便利店/小超市,3.标超/卖场。默认 全部
class_name	否	String(50)	饮料	大类名称。可选值：大类小类中的大类名名称，空字符串-全部。默认 空字符串。province_code=1时，不支持指定大类名称，按空字符处理
category_name	否	String(50)	乳饮料	小类名称。可选值：大类小类中的小类名称，空字符串-全部。默认 空字符串。province_code=1时，不支持指定大类名称，按空字符处理
sort_type	否	string(10)	QUANTITY	排名方式：销售额.AMOUNT,按销量.QUANTITY。默认 AMOUNT
offset	否	int	0	查询偏移量：从0开始。默认 0

xml请求示例：

<xml>
    <version>1.0.0</version>
    <charset>UTF-8</charset>
    <sign_type>MD5</sign_type>
    <appid>12012325</appid>
    <nonce_str>5K8264ILTKCH16CQ</nonce_str>
    <method>top.products.month.get</method>
    <province_code>110000</province_code>
    <date>2020-04-01</date>
    <business_type>2</business_type>
    <sort_type>AMOUNT</sort_type>
    <sign>5AB20AA09142821ABF4A2A38F71303B3</sign>
</xml>

json请求示例：

{
  "version": "1.0.0",
  "charset": "UTF-8",
  "sign_type": "MD5",
  "method": "top.products.month.get",
  "nonce_str": "5K8264ILTKCH16CQ",
  "appid": "12012325",
  "province_code": "110000",
  "date": "2020-04-01",
  "business_type": 2,
  "sort_type": "AMOUNT",
  "sign": "5AB20AA09142821ABF4A2A38F71303B3"
}

返回结果

参数名称	必填	类型	示例	说明
list	是	Text		畅销商品榜列表,JSON格式，详见下文［畅销商品榜列表字段说明］
total	是	String(10)		商品数量：按照大类查询最多可返回200条数据，按小类查询最多可返回60条数据
date	是	String(10)		日期
province_code	是	String(10)		省份编码
business_type	是	int		行业类型,1.全部,2.便利店/小超市,3.标超/卖场。

畅销商品榜列表字段说明:

参数名称	必填	类型	示例	说明
sort	是	String(10)		排名
sort_change	是	string		排行变动，正数：下降名次，负数：上升名次，0：持平，null：新上榜
product_id	是	String(13)		商品条码
name	是	String(255)		商品名称
average_price	是	float		平均价格（元）
median_price	是	float		售价中位数（元）
category_name	是	String(40)		小类名称
brand_name	是	String(40)		品牌名称
class_name	是	String(40)		大类名称

xml返回示例：

<xml>
    <list>
        <![CDATA[[{"sort":1,"sort_change":"1","product_id":"6921355221411","name":"三元特品纯牛奶243ml","average_price":"2.32","median_price":"2.50","category_name":"非酒精饮料","class_name":"饮料"},{"sort":2,"sort_change":"-1","product_id":"6940211889602","name":"养乐多活菌型乳酸菌饮品原味100ml*5","average_price":"12.02","median_price":"12.00","category_name":"非酒精饮料","class_name":"饮料"},{......}]]]>
    </list>
    <total>200</total>
    <date>2020-04-20</date>
    <province_code>110000</province_code>
    <business_type>1</business_type>
    <charset>UTF-8</charset>
    <version>1.0.0</version>
    <sign_type>MD5</sign_type>
    <nonce_str>5e9e69d38df51</nonce_str>
    <return_code>SUCCESS</return_code>
    <result_code>SUCCESS</result_code>
    <appid>12012325</appid>
    <sign>CA2ECB0B65B744B257F816F5DB308F22</sign>
</xml>

json返回示例：

{
  "list": "[{\"sort\":1,\"sort_change\":\"1\",\"product_id\":\"6921355221411\",\"name\":\"三元特品纯牛奶243ml\",\"average_price\":\"2.32\",\"median_price\":\"2.50\",\"category_name\":\"非酒精饮料\",\"class_name\":\"饮料\"},{\"sort\":2,\"sort_change\":\"-1\",\"product_id\":\"6940211889602\",\"name\":\"养乐多活菌型乳酸菌饮品原味100ml*5\",\"average_price\":\"12.02\",\"median_price\":\"12.00\",\"category_name\":\"非酒精饮料\",\"class_name\":\"饮料\"},{......}]",
  "total": 200,
  "date":"2022-09-01",
  "province_code":"110000",
  "business_type":1,
  "charset": "UTF-8",
  "version": "1.0.0",
  "sign_type": "MD5",
  "nonce_str": "5e97cfb9cfef3",
  "return_code": "SUCCESS",
  "result_code": "SUCCESS",
  "appid": "12012325",
  "sign": "0388D5D4C2D3A526C74FB193D30BED56"
}