精准搜索
<p><strong>简要描述:</strong> </p>
<ul>
<li>用途:用户一打开APP,就根据用户剪贴板里的文字检索出一个商品,以弹窗形式展示给用户</li>
<li>根据keyword,返回一个最符合条件的商品</li>
<li>支持通过某个淘宝商品的淘口令,解析出对应的商品</li>
<li>支持通过某个京东商品的长链接或短链接,搜到对应的商品</li>
</ul>
<p><strong>参考效果:</strong>
搜索更多->调【按关键词/商品链接搜索】接口;
领取优惠券->进入商品详情页;
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/ed1b20c4b63318b915ae0ea58ea3e4c6?showdoc=.jpg" alt="" /></p>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/goods/deep_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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">keyword</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>搜索词</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price)</td>
</tr>
<tr>
<td style="text-align: left;">has_coupon</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">boolean</td>
<td>优惠券筛选-是否有优惠券。true表示该商品有优惠券,false或不设置表示不限</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>-- 命中屏蔽策略 返回结果
{
"code": 2002,
"msg": "搜索词命中屏蔽策略",
"data": null
}
-- 匹配到商品 返回结果
{
"code": 0,
"msg": "返回成功",
"data": {
"item_id": 596004849991,
"title": "索爱 官方T1老人手机直板超长待机三防老年机移动电信版手机大屏大字大声老人机正品大按键全网通女老年手机",
"coupon_money": "20",
"coupon_money_text": "领券省20",
"activity_id": "70eee161b0b542d89ee5109b3490dc5f",
"cover_image": "https://img.alicdn.com/bao/uploaded/i2/656571488/O1CN01SDQ2TH1MrXuw78GGj_!!0-item_pic.jpg",
"month_sales": 782,
"price": "99",
"discount_price": "79.00",
"tk_rate": 20.01,
"fl_commission": "",
"shop_name": "百吉利数码专营店",
"mall_id": 2,
"mall_icon": "http://img.daff9.cn/resource/tmall.png",
"type": 1,
}
}
-- 匹配不到商品 返回结果
{
"code": 0,
"msg": "返回成功",
"data": null
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</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>
</tr>
<tr>
<td style="text-align: left;">activity_id</td>
<td style="text-align: left;">string</td>
<td>券ID</td>
</tr>
<tr>
<td style="text-align: left;">cover_image</td>
<td style="text-align: left;">string</td>
<td>商品图片</td>
</tr>
<tr>
<td style="text-align: left;">coupon_money</td>
<td style="text-align: left;">string</td>
<td>券面值</td>
</tr>
<tr>
<td style="text-align: left;">coupon_money_text</td>
<td style="text-align: left;">string</td>
<td>券面值文案</td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">string</td>
<td>商品标题</td>
</tr>
<tr>
<td style="text-align: left;">month_sales</td>
<td style="text-align: left;">string</td>
<td>月销量</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">string</td>
<td>商品原价(元)</td>
</tr>
<tr>
<td style="text-align: left;">discount_price</td>
<td style="text-align: left;">string</td>
<td>商品券后价(元)</td>
</tr>
<tr>
<td style="text-align: left;">tk_rate</td>
<td style="text-align: left;">string</td>
<td>佣金比 百分之20 则为 20</td>
</tr>
<tr>
<td style="text-align: left;">fl_commission</td>
<td style="text-align: left;">string</td>
<td>返利金额(返利模式有效)</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">string</td>
<td>店铺名称</td>
</tr>
<tr>
<td style="text-align: left;">mall_id</td>
<td style="text-align: left;">int</td>
<td>商城类型 1:淘宝 2:天猫</td>
</tr>
<tr>
<td style="text-align: left;">mall_icon</td>
<td style="text-align: left;">string</td>
<td>商城icon</td>
</tr>
</tbody>
</table>
<p><strong>错误码</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">错误码</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10001</td>
<td style="text-align: left;">PID参数错误</td>
</tr>
<tr>
<td style="text-align: left;">10002</td>
<td style="text-align: left;">淘宝授权过期</td>
</tr>
<tr>
<td style="text-align: left;">2002</td>
<td style="text-align: left;">搜索词命中屏蔽策略</td>
</tr>
</tbody>
</table>