新品热卖
应用场景
查询指定新品热卖榜单信息,每月5号中午12点更新上月数据。包括日期、大区、行业类型、类目名称、商品条码、商品名称、售价中位数(元)、品牌名称、是否爆品。
请求参数
接口名称: top.new.products.get
| 参数名称 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| date | 否 | String(10) | 2020-04-01 | yyyy-MM-dd,每月一号,若不填,默认日期为上个月1号(若当天日期为当月1-5号,则默认为上上个月1号) |
| region_code | 是 | String(10) | 100000 | 大区编码。 100000(华北地区),200000(东北地区) ,300000(华东地区),400000(华中地区),600000(西北地区),700000(西南地区),800000(华南地区) |
| business_type | 否 | int | 2 | 行业类型:1.全部,2.便利店/小超市,3.标超/卖场。默认 全部 |
| class_name | 否 | String(50) | 全部大类 | 大类名称。可选值-查询范围:全部大类-不分类目的排行榜,大类名称-大类排行榜,空字符串-所有排行榜。默认 空字符串 |
| offset | 否 | int | 0 | 查询偏移量:从0开始。默认 0 |
| length | 否 | int | 2000 | 查询数量:最大值3000。默认 2500 |
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.new.products.get</method>
<region_code>100000</region_code>
<date>2020-04-01</date>
<business_type>2</business_type>
<sign>5AB20AA09142821ABF4A2A38F71303B3</sign>
</xml>
json请求示例:
{
"version": "1.0.0",
"charset": "UTF-8",
"sign_type": "MD5",
"method": "top.new.products.get",
"nonce_str": "5K8264ILTKCH16CQ",
"appid": "12012325",
"region_code": "100000",
"date": "2020-04-01",
"business_type": 2,
"sort_type": "AMOUNT",
"sign": "5AB20AA09142821ABF4A2A38F71303B3"
}
返回结果
| 参数名称 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| list | 是 | Text | 新品热卖商品列表,JSON格式,详见下文[新品热卖商品列表字段说明] | |
| total | 是 | int | 商品总数量 | |
| date | 是 | String(10) | 日期 | |
| region_code | 是 | String(10) | 大区编码 | |
| business_type | 是 | int | 行业类型,1.全部,2.便利店/小超市,3.标超/卖场。 |
新品热卖商品列表字段说明:
| 参数名称 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| product_id | 是 | String(13) | 商品条码 | |
| name | 是 | String(255) | 商品名称 | |
| median_price | 是 | float | 售价中位数(元) | |
| class_name | 是 | String(40) | 大类名称 | |
| brand_name | 是 | String(40) | 品牌名称 | |
| is_hot | 是 | bool | 是否爆品 |
xml返回示例:
<xml>
<list>
<![CDATA[[{"is_hot":true,"product_id":"6921355221411","name":"三元特品纯牛奶243ml","median_price":"2.50","class_name":"非酒精饮料","brand_name":"三元"},{"is_hot":false,"product_id":"6940211889602","name":"养乐多活菌型乳酸菌饮品原味100ml*5","median_price":"12.00","class_name":"非酒精饮料","brand_name":"养乐多"}]]]>
</list>
<total>2</total>
<date>2020-04-01</date>
<region_code>100000</region_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": "[{\"is_hot\":true,\"product_id\":\"6921355221411\",\"name\":\"三元特品纯牛奶243ml\",\"median_price\":\"2.50\",\"brand_name\":\"三元\",\"class_name\":\"非酒精饮料\"},{\"is_hot\":false,\"product_id\":\"6940211889602\",\"name\":\"养乐多活菌型乳酸菌饮品原味100ml*5\",\"median_price\":\"12.00\",\"class_name\":\"非酒精饮料\",\"brand_name\":\"品牌名称\"}]",
"total": 2,
"date":"2022-09-01",
"region_code":"100000",
"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"
}