商品列表
<p><strong>简要描述:</strong> </p>
<ul>
<li>支持淘、京、拼三大平台</li>
<li>淘宝特色列表:淘抢购、聚划算、9.9包邮、实时热卖</li>
<li>拼多多特色列表:1.9包邮、今日爆款(每10分钟计算1次销量)、品牌清仓</li>
<li>京东特色列表:好券商品、超级大卖场、9.9专区、热销爆品、数码家电、超市、母婴玩具、家具日用、美妆穿搭、医药保健、图书文具、今日必推、王牌好货</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/goods/items</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong> 淘宝请求参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">是否必填</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">平台</td>
<td style="text-align: left;">是</td>
<td>int</td>
<td>1.淘宝 2.天猫</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">排序</td>
<td style="text-align: left;">否</td>
<td>srting</td>
<td>综合(不传)、 价格(discount_price_des, discount_price_asc)、 销量(month_sales_des, month_sales_asc)、 佣金比例(tk_rate_des ,tk_rate_asc)</td>
</tr>
<tr>
<td style="text-align: left;">activity_type</td>
<td style="text-align: left;">特色列表</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>1-普通商品 2-淘抢购 3-聚划算 4-九块九 5-淘宝物料接口(不支持排序) 6-实时热卖(不支持排序) 默认1</td>
</tr>
<tr>
<td style="text-align: left;">category_id</td>
<td style="text-align: left;">类目ID</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>商品分类ID,类目接口获取</td>
</tr>
<tr>
<td style="text-align: left;">material_id</td>
<td style="text-align: left;"><a href="https://www.showdoc.cc/p/a11795d70170a0209f44f8bf73d008e8" title="物料ID">物料ID</a></td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>仅activity_type=5生效</td>
</tr>
<tr>
<td style="text-align: left;">coupon_start</td>
<td style="text-align: left;">最小优惠券面额</td>
<td style="text-align: left;">否</td>
<td>string</td>
<td>仅activity_type=1,2,3,4有效,单位:元</td>
</tr>
<tr>
<td style="text-align: left;">coupon_end</td>
<td style="text-align: left;">最大优惠券面额</td>
<td style="text-align: left;">否</td>
<td>string</td>
<td>仅activity_type=1,2,3,4有效,单位:元</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">页码</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>默认1</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">每页数据量</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>【1,100】默认20</td>
</tr>
</tbody>
</table>
<p><strong> 拼多多请求参数 </strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">是否必填</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">平台</td>
<td style="text-align: left;">是</td>
<td>int</td>
<td>3:拼多多</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">排序</td>
<td style="text-align: left;">否</td>
<td>srting</td>
<td>综合(不传)、 价格(discount_price_des, discount_price_asc)、 销量(month_sales_des, month_sales_asc)、 佣金比例(tk_rate_des ,tk_rate_asc)</td>
</tr>
<tr>
<td style="text-align: left;">activity_type</td>
<td style="text-align: left;">特色列表</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>1-普通商品列表 3-爆款排行商品(不支持排序) 30-1.9包邮(不支持排序) 31-今日爆款(不支持排序) 32-品牌清仓(不支持排序) ,34-相似商品推荐,35-猜你喜欢,36-实时热销,37-实时收益,38-今日畅销,39-高佣榜单 默认1</td>
</tr>
<tr>
<td style="text-align: left;">activity_tags</td>
<td style="text-align: left;">商品活动</td>
<td style="text-align: left;">否</td>
<td>string</td>
<td>activity_type为1生效,4秒杀7百亿补贴,可以传入多个值用英文逗号分割,例如4,7</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">页码</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>默认1</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">每页数据量</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>【1,100】默认20</td>
</tr>
</tbody>
</table>
<p><strong> 京东请求参数 </strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th style="text-align: left;">是否必填</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">平台</td>
<td style="text-align: left;">是</td>
<td>int</td>
<td>4:京东</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">排序</td>
<td style="text-align: left;">否</td>
<td>srting</td>
<td>综合(不传)、 价格(discount_price_des, discount_price_asc)、 销量(month_sales_des, month_sales_asc)、 佣金比例(tk_rate_des ,tk_rate_asc)</td>
</tr>
<tr>
<td style="text-align: left;">channel_type</td>
<td style="text-align: left;">特色列表</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>1-好券商品,2-精选卖场,10-9.9包邮,15-京东配送,22-实时热销榜,23-为你推荐,24-数码家电,25-超市,26-母婴玩具,27-家具日用,28-美妆穿搭,30-图书文具,31-今日必推,32-京东好物,33-京东秒杀,34-拼购商品,40-高收益榜,41-自营热卖榜,109-新品首发,110-自营,112-京东爆品,125-首购商品,129-高佣榜单,130-视频商品,153-历史最低价商品榜</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">页码</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>默认1</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">每页数据量</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>【1,100】默认20</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
"code": 0,
"msg": "返回成功",
"data": {
"items": [
{
"item_id": 6520968300,
"title": "diy双面抱枕定制照片来图印两用靠垫枕头订做可爱礼物送男女生日",
"coupon_money": 2,
"coupon_money_text": "领券省2",
"activity_id": 0,
"cover_image": "https://t00img.yangkeduo.com/goods/images/2019-05-25/0a5e659a055aec9b01cc95d381b3531b.jpeg",
"month_sales": 38964,
"price": "6.90",
"discount_price": "4.90",
"tk_rate": 20,
"fl_commission": "赚0.34",
"shop_name": "GUYA顾雅家纺专卖店",
"mall_id": 3,
"mall_icon": "https://rebate-robot.oss-cn-hangzhou.aliyuncs.com/mini_program/pin.png",
"type": 1,
"presale_deposit": 0,
"presale_discount_fee_text": "",
"presale_end_time": "",
"presale_start_time": "",
"presale_tail_end_time": "",
"presale_tail_start_time": "",
},
{
"item_id": 2574921541,
"title": "【7.9元限时抢,抢完恢复9.9元】【40卷24卷10卷】5.6斤40卷植护本色卫生纸巾卷纸批发家用厕纸",
"coupon_money": 1,
"coupon_money_text": "领券省1",
"activity_id": 0,
"cover_image": "https://t00img.yangkeduo.com/goods/images/2019-04-27/cfd271f31585fbfaa0e7372061d12b13.jpeg",
"month_sales": 1315832,
"price": "7.90",
"discount_price": "6.90",
"tk_rate": 20,
"fl_commission": "赚0.43",
"fl_commission_amount": 43,
"shop_name": "素木岭家居专营店",
"mall_id": 3,
"mall_icon": "https://rebate-robot.oss-cn-hangzhou.aliyuncs.com/mini_program/pin.png",
"type": 1,
"presale_deposit": 0,
"presale_discount_fee_text": "",
"presale_end_time": "",
"presale_start_time": "",
"presale_tail_end_time": "",
"presale_tail_start_time": "",
}
],
"has_next": true
}
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">item_id</td>
<td style="text-align: left;">商品ID</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">商品标题</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">coupon_money</td>
<td style="text-align: left;">优惠券面值</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">coupon_money_text</td>
<td style="text-align: left;">优惠券面值文案</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">activity_id</td>
<td style="text-align: left;">优惠券ID</td>
<td>string</td>
<td>可为空</td>
</tr>
<tr>
<td style="text-align: left;">cover_image</td>
<td style="text-align: left;">商品主图</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">month_sales</td>
<td style="text-align: left;">月销量</td>
<td>int</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">商品原价</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">discount_price</td>
<td style="text-align: left;">商品券后价</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">tk_rate</td>
<td style="text-align: left;">佣金比</td>
<td>float</td>
<td>单位:%</td>
</tr>
<tr>
<td style="text-align: left;">fl_commission</td>
<td style="text-align: left;">返利金额</td>
<td>string</td>
<td>例:赚3.28</td>
</tr>
<tr>
<td style="text-align: left;">fl_commission_amount</td>
<td style="text-align: left;">返利金额</td>
<td>string</td>
<td>单位:分</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">店铺名称</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">类型</td>
<td>int</td>
<td>1-商品 2-广告位</td>
</tr>
<tr>
<td style="text-align: left;">mall_icon</td>
<td style="text-align: left;">平台logo</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">平台类型</td>
<td>int</td>
<td>1-淘宝 2-天猫 3-拼多多 4-京东</td>
</tr>
</tbody>
</table>
<p><strong>以下参数仅淘宝/天猫有返回值</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名称</th>
<th style="text-align: left;">参数描述</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">presale_deposit</td>
<td style="text-align: left;">预售定金金额</td>
<td>string</td>
<td>仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_discount_fee_text</td>
<td style="text-align: left;">商品优惠信息</td>
<td>string</td>
<td>仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_start_time</td>
<td style="text-align: left;">付定金开始时间</td>
<td>int</td>
<td>单位:毫秒 仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_end_time</td>
<td style="text-align: left;">付定金结束时间</td>
<td>int</td>
<td>单位:毫秒 仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_tail_start_time</td>
<td style="text-align: left;">付尾款开始时间</td>
<td>int</td>
<td>单位:毫秒 仅双十一大促期间有效</td>
</tr>
<tr>
<td style="text-align: left;">presale_tail_start_time</td>
<td style="text-align: left;">付尾款结束时间</td>
<td>int</td>
<td>单位:毫秒 仅双十一大促期间有效</td>
</tr>
</tbody>
</table>