按关键词/商品链接搜索
<h4>更新说明</h4>
<ul>
<li>month_sales|月销量| int => string 拼多多返销量存在字符串情况 统一将销量改成字符串格式 -- 2020年06月16日</li>
</ul>
<p><strong>简要描述:</strong> </p>
<ul>
<li>支持淘、京、拼三大平台</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/goods/search</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;">keyword</td>
<td style="text-align: left;">搜索词</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>链接、关键词都用此字段</td>
</tr>
<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.天猫 3.拼多多 4.京东</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">排序</td>
<td style="text-align: left;">否</td>
<td>string</td>
<td>价格(discount_price_des, discount_price_asc) 销量(month_sales_des, month_sales_asc) 综合(不用传)</td>
</tr>
<tr>
<td style="text-align: left;">has_coupon</td>
<td style="text-align: left;">是否只查询有券商品</td>
<td style="text-align: left;">否</td>
<td>boolean</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">start_price</td>
<td style="text-align: left;">最低价</td>
<td style="text-align: left;">否</td>
<td>float</td>
<td>单位元</td>
</tr>
<tr>
<td style="text-align: left;">end_price</td>
<td style="text-align: left;">最高价</td>
<td style="text-align: left;">否</td>
<td>float</td>
<td>单位元</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;">is_tmall</td>
<td style="text-align: left;">商品是否来自天猫</td>
<td style="text-align: left;">否</td>
<td>boolean</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">is_overseas</td>
<td style="text-align: left;">是否属于海外商品</td>
<td style="text-align: left;">否</td>
<td>boolean</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">need_free_shipment</td>
<td style="text-align: left;">商品是否包邮</td>
<td style="text-align: left;">否</td>
<td>boolean</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">need_prepay</td>
<td style="text-align: left;">商品是否加入消费者保障</td>
<td style="text-align: left;">否</td>
<td>boolean</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">activity_type</td>
<td style="text-align: left;">活动ID</td>
<td style="text-align: left;">否</td>
<td>int</td>
<td>1111.只看双十一预售商品 (仅双十一大促期间有效)</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
"code": "0",
"msg": "返回成功",
"data": {
"items": [
{
"item_id": 575941593909,
"title": "丝叔潮社pso brand春秋蓝黑衬衫",
"coupon_money": 20,
"coupon_money_text": "领券省20",
"activity_id": "ca300915005e449cbb414461a61cde87",
"cover_image": "https://img.alicdn.com/bao/uploaded/i2/336016874/O1CN01bCTATt20eL4WTStp8_!!336016874.jpg_300x300.jpg",
"month_sales": 727,
"price": "218",
"discount_price": "198",
"tk_rate": 3.31,
"fl_commission": "赚0.43",
"fl_commission_amount": 43,
"shop_name": "丝叔潮社",
"mall_id": 1,
"mall_icon": "http://img.daff9.cn/resource/taobao.png",
"type": 1
},
{
"item_id": 591031948670,
"title": "特borakoo韩国东大门夏正品~衬衫",
"coupon_money": 0,
"coupon_money_text": "",
"activity_id": "",
"cover_image": "https://img.alicdn.com/bao/uploaded/i4/507041745/O1CN01YdnImZ1OlFeKaQx5b_!!507041745.jpg_300x300.jpg",
"month_sales": 121,
"price": "322",
"discount_price": "322",
"tk_rate": 4.5,
"fl_commission": "赚0.43",
"fl_commission_amount": 43,
"shop_name": "波拉家韩国代购正品",
"mall_id": 1,
"mall_icon": "http://img.daff9.cn/resource/taobao.png",
"type": 1
}
],
"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;">string</td>
<td>商品ID</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>int</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>string</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></td>
</tr>
<tr>
<td style="text-align: left;">fl_commission_amount</td>
<td style="text-align: left;">返利金额</td>
<td>int</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>