Skip to content

新品情报站批量查询接口

应用场景

查询指定新品情报站榜单信息，每月2号中午12点更新上月数据。包括日期、大区、行业类型、类目名称、商品条码、商品名称、是否爆品、售价中位数（元）、品牌名称。

请求参数

接口名称: top.new.products.bulkget

参数名称 必填 类型 示例 说明
report_date 否 String(10) 2020-04-01 yyyy-MM-dd，每月一号，若不填，默认日期为上个月1号（若当天日期为当月1号、2号，则默认为上上个月1号）

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.bulkget</method>
    <report_date>2020-04-01</report_date>
    <sign>5AB20AA09142821ABF4A2A38F71303B3</sign>
</xml>

json请求示例：

{
  "version": "1.0.0",
  "charset": "UTF-8",
  "sign_type": "MD5",
  "method": "top.new.products.bulkget",
  "nonce_str": "5K8264ILTKCH16CQ",
  "appid": "12012325",
  "report_date": "2020-04-01",
  "sign": "5AB20AA09142821ABF4A2A38F71303B3"
}

返回结果

参数名称 必填 类型 示例 说明
report_url 是 String(255) https://img.17gaoda.com/dev/17gaoda/xxx.csv 文件下载地址，文件内容详见[文件字段说明]

文件字段说明：

字段名称 必填 类型 示例 说明
日期 是 String(8) 20200420 yyyyMMdd
大区 是 String(20) 华北地区
是否爆品 是 bool true 是否爆品
商品条码 是 String(13) 6916168616226
商品名称 是 String(255) 鲁花5S压榨一级花生油1.8L
售价中位数（元） 是 float 50.5
类目名称 是 String(20) 非饮料类目
品牌名称 是 String(20) 鲁花
行业类型 是 String(20) 便利店/小超市 行业类型：全部行业、便利店/小超市、标超/卖场

xml返回示例：

<xml>
    <report_url>
        <![CDATA[http://qmgy-oss-private.oss-cn-beijing.aliyuncs.com/reports/yuanqi/yuanqi_Top_Products_20200330-20200412.csv?OSSAccessKeyId=2j9237bV8q625QZy&Expires=1587099998&Signature=os%2F%2FSN%2FoxVdPZduLN5NL6lCZFAc%3D]]>
    </report_url>
    <charset>UTF-8</charset>
    <version>1.0.0</version>
    <sign_type>MD5</sign_type>
    <nonce_str>5e97e7dea79ed</nonce_str>
    <return_code>SUCCESS</return_code>
    <result_code>SUCCESS</result_code>
    <appid>12012325</appid>
    <sign>F2D30010A3D075CDB0BEEE83EFD9CB53</sign>
</xml>

json返回示例：

{
    "report_url": "http://qmgy-oss-private.oss-cn-beijing.aliyuncs.com/reports/yuanqi/yuanqi_Top_Products_20200330-20200412.csv?OSSAccessKeyId=2j9237bV8q625QZy&Expires=1587099998&Signature=os//SN/oxVdPZduLN5NL6lCZFAc=",
    "charset": "UTF-8",
    "version": "1.0.0",
    "sign_type": "MD5",
    "nonce_str": "5e97e812b2f37",
    "return_code": "SUCCESS",
    "result_code": "SUCCESS",
    "appid": "12012325",
    "sign": "E5CF516AFFB1C5648CDD47B2137A1FCC"
}