新品情报站
应用场景
查询指定新品情报站榜单信息,每月2号中午12点更新上月数据。包括日期、大区、行业类型、类目名称、商品条码、商品名称、售价中位数(元)、品牌名称、是否爆品。
请求参数
接口名称: top.new.products.get
参数名称 | 必填 | 类型 | 示例 | 说明 |
---|---|---|---|---|
district_code | 是 | String(10) | 100000 | 大区编码。 100000(华北地区),200000(东北地区) ,300000(华东地区),400000(华中地区),600000(西北地区),700000(西南地区),800000(华南地区) |
date | 否 | String(10) | 2020-04-01 | yyyy-MM-dd,每月一号,若不填,默认日期为上个月1号(若当天日期为当月1号、2号,则默认为上上个月1号) |
business_type | 否 | int | 2 | 行业类型:1.全部,2.便利店/小超市,3.标超/卖场。默认 全部 |
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>
<district_code>100000</district_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",
"district_code": "100000",
"date": "2020-04-01",
"business_type": 2,
"sort_type": "AMOUNT",
"sign": "5AB20AA09142821ABF4A2A38F71303B3"
}
返回结果
参数名称 | 必填 | 类型 | 示例 | 说明 |
---|---|---|---|---|
list | 是 | Text | 新品情报站商品列表,JSON格式,详见下文[新品情报站商品列表字段说明] | |
total | 是 | int | 商品总数量 | |
date | 是 | String(10) | 日期 | |
region | 是 | String(10) | 大区编码 | |
business_type | 是 | int | 行业类型,1.全部,2.便利店/小超市,3.标超/卖场。 |
新品情报站商品列表字段说明:
参数名称 | 必填 | 类型 | 示例 | 说明 |
---|---|---|---|---|
product_id | 是 | String(13) | 商品条码 | |
name | 是 | String(255) | 商品名称 | |
area_price | 是 | float | 售价中位数(元) | |
category_name | 是 | String(40) | 类目名称 | |
brand_name | 是 | String(40) | 品牌名称 | |
is_hot | 是 | bool | 是否爆品 |
xml返回示例:
<xml>
<list>
<![CDATA[[{"is_hot":true,"product_id":"6921355221411","name":"三元特品纯牛奶243ml","area_price":"2.50","category_name":"非酒精饮料","brand_name":"三元"},{"is_hot":false,"product_id":"6940211889602","name":"养乐多活菌型乳酸菌饮品原味100ml*5","area_price":"12.00","category_name":"非酒精饮料","brand_name":"养乐多"}]]]>
</list>
<total>2</total>
<date>2020-04-01</date>
<region>100000</region>
<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\",\"area_price\":\"2.50\",\"brand_name\":\"三元\",\"category_name\":\"非酒精饮料\"},{\"is_hot\":false,\"product_id\":\"6940211889602\",\"name\":\"养乐多活菌型乳酸菌饮品原味100ml*5\",\"area_price\":\"12.00\",\"category_name\":\"非酒精饮料\",\"brand_name\":\"品牌名称\"}]",
"total": 2,
"date":"2022-09-01",
"region":"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"
}