采购精选

应用场景

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

请求参数

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

参数名称	必填	类型	示例	说明
district_code	是	String(10)	110000	参考省份编码
date	否	String(10)	2020-04-01	yyyy-MM-dd，每月一号，若不填，默认日期为上个月1号（若当天日期为当月1号、2号，则默认为上上个月1号）
business_type	否	int	2	行业类型：1.全部,2.便利店/小超市,3.标超/卖场。默认 全部
sort_type	否	string(10)	QUANTITY	排名方式：销售额.AMOUNT,按销量.QUANTITY。默认 AMOUNT

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>
    <district_code>110000</district_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",
  "district_code": "110000",
  "date": "2020-04-01",
  "business_type": 2,
  "sort_type": "AMOUNT",
  "sign": "5AB20AA09142821ABF4A2A38F71303B3"
}

返回结果

参数名称	必填	类型	示例	说明
list	是	Text		采购精选商品列表,JSON格式，详见下文［采购精选商品列表字段说明］
total	是	String(10)		商品总数量
date	是	String(10)		日期
province	是	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		平均价格（元）
area_price	是	float		售价中位数（元）
category_name	是	String(40)		类目名称
brand_name	是	String(40)		品牌名称

xml返回示例：

<xml>
    <list>
        <![CDATA[[{"sort":1,"sort_change":"1","product_id":"6921355221411","name":"三元特品纯牛奶243ml","average_price":"2.32","area_price":"2.50","category":"非酒精饮料"},{"sort":2,"sort_change":"-1","product_id":"6940211889602","name":"养乐多活菌型乳酸菌饮品原味100ml*5","average_price":"12.02","area_price":"12.00","category":"非酒精饮料"},{......}]]]>
    </list>
    <total>2500</total>
    <date>2020-04-20</date>
    <province>110000</province>
    <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\",\"area_price\":\"2.50\",\"category\":\"非酒精饮料\"},{\"sort\":2,\"sort_change\":\"-1\",\"product_id\":\"6940211889602\",\"name\":\"养乐多活菌型乳酸菌饮品原味100ml*5\",\"average_price\":\"12.02\",\"area_price\":\"12.00\",\"category\":\"非酒精饮料\"},{......}]",
    "total": 2500,
    "date":"2022-09-01",
    "province":"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"
}