超级搜索接口使用说明：

超级搜索接口，打造媲美“花生日记、美逛、好省”的强大搜索引擎！

好搜索，更好把握你的每一次成交机会！

此超级搜索接口完全按客户在APP或公众号、网站的搜索场景来开发。搜索接口具有以处功能和特征：

1、【强大的参数处理能力】接收五花八门的关键字进行泛搜索，获取产品列表。经一年多升级，可处理各种非常规关键字。

2、【定向搜索】当您的客户使用从手淘等处复制的淘口令/喵口令、五花八门链接等内容，接口将直接转链出客户指定的产品。

3、【找相似功能】当查找淘宝联盟以外的商品时，普通搜索无法获取结果，而本接口直接把该商品的标题拿来搜索，给客户返回同类产品列表。

4、【分词功能】部分搜索标题因太长等原因，普通搜索无返回值，而本接口将触发分词功能返回搜索结果。

5、【完全高佣】搜索获取的产品全部显示高佣，方便您在应用中准确计算分享给客户的佣金金额。

本搜索接口经过一年多的不断升级和客户反馈，为您打造不亚于“花生日记、美逛、好省”等APP的搜索能力。

一、接口地址（域名 apis.vephp.com）：

http://apis.vephp.com/super?vekey=V1231xxxxxxx&para=各种关键字/淘口令/链接等参数

【案例】 如何用超级搜索功能做 9.9元包邮？

二、接口功能：

接口所有搜索返回的产品列表显示的佣金都是高佣金。

接口增强：1、长标题搜索无结果时进行分词。2、淘宝联盟以外的商品进行标题搜索找相似。

1、关键字匹配搜索——使用关键字或商品标题搜索符合条件产品列表。

用于你的客户，在APP或网站或公众号等应用中，直接使用关键字或产品标题来搜索（文字请做url编码传递）。接口对内容做了优化，当无结果时，将进行分词搜索。

http://apis.vephp.com/super?vekey=V000xxxx&para=拉杆箱

也可以用分类ID查，使用 cat参数（详细淘宝分类数据请联系客服），这时可不必传递para，如：

http://apis.vephp.com/super?vekey=xxxxx&cat=50011129

【注意】更多参数请阅读下文。

2、直接定向搜索指定产品：

顾客在您的APP或网站，不会每次都是输入产品关键字来搜索，很多时侯，她会输入一个手淘APP或者同行那里复制的淘口令/喵口令、或者各种五花八门的淘宝天猫链接等等，看看你这里有没有这个产品的优惠券。

面对这种场景，当您把顾客输入的这些“产品id，链接，淘口令...”等内容时，接口理解为客户指定搜索该产品，这时如果返回一堆产品列表，反而会打乱客户购买，因此，接口只返回客户这个指定产品的详情和高佣推广链接。

【注意】

1、此时接口返回值和参数，与万能高佣转链接口hcapi一致。

2、您也可以指定 onlysearch 参数，强制使用该产品标题来搜索同类产品。但不建议这么做，可能会打乱客户购买决策。

3、此时如果商品是非淘宝联盟的商品，可以指定参数similar=1，则接口会使用它的标题去搜索相拟产品。

例1：搜索天猫指定产品：

http://apis.vephp.com/super?vekey=xxx&para=http://zmnxbc.com/s/YJk6Z

这个链接本身是从天猫APP中复制的（实际参数你可以直接把客户完整的内容传递给接口）。

这种情形下，super接口会直接识别出其中的产品，并转换成高佣转链功能，这时返回的结果不是产品列表，而是和hcapi高佣转链结果一样的返回值。

【特别说明】当super转换为转链功能时，它的参数和hcapi高佣接口功能一样。因此您可以用hcapi接口参数

但是，如果您想在客户搜索淘口令或链接时，也使用该商品标题搜索同类产品，那么可以指定 onlysearch 参数（参考下文参数说明） ，这时接口会用解析参数后的产品标题做关键字搜索。

例2：搜索产品并使用自动找相似功能：

http://apis.vephp.com/super?vekey=xxx&para=￥NchgbxBILRt￥&similar=1

指定参数similar=1后，当搜索参数para为指定产品并且非淘宝联盟的产品（没有佣金），这时接口会自动用这个产品的标题搜索，找出相似的产品。

三、超级搜索返回值：

超级搜索API接口做了大量优化，更优的排序，更深层的查询。

【重要：关于commission_rate佣金比率字段值不同的说明】

接口返回值类型有2种：泛搜索和定向搜索，一定要看返回值search_type字段，返回值中search_type字段值为1时是泛搜索，2时是定向搜索（和万能转链hcapi接口一样）

（1）泛搜索：这时接口返回search_type=1，返回值字段佣金比率“commission_rate”需要除以100，比如5000表示50%。

（2）定向搜索：而如果搜索指定商品，此时search_type=2时，这时返回值中的commission_rate字段不需要除以100，是正常佣金百分值。如50.0表示50%

【关于帐号初级或中级导致的佣金率不一致问题】

问：为什么我用关键字调用搜索接口时，返回返回产品列表中某产品佣金率commission_rate， 和使用该产品的淘口令或链接做参数调用搜索或转链接口时，返回的commission_rate不一样？

答：因为搜索接口泛搜索时（即使用关键字搜索或非联盟商品找相似搜索），返回的产品列表是按“最高佣金”显示的，方便做返利型APP的在搜索列表展示中直接显示会员可取多少分佣。但是你能否拿到这个最高佣金，要按你的帐户级别，只有高级帐号才可以，如果是初级或中级帐号，就会显示的佣金比例比泛搜索低。所以，只要把帐号升级即可。

可委托本站升级，全过程需要3天时间。

搜索返回值详解如下：

1、若使用关键字搜索到商品列表，则返回结果列表。返回值（包含result_list字段）：

使用场景：

（1）使用普通关键字搜索，比如“女装”。

（2）客户搜索的商品是非淘宝联盟的商品，也会转换为关键字搜索。

以下是此时返回值，返回值详情和字段含义参 http://wsd.591hufu.com/taokelianmeng/201.html

{

    "error": "0",

    "msg": "查询成功！",

    "search_type": "1",  # 1表示搜索产品关键字，2表示转链

    "is_similar":"0",   # 是否找相似搜索：0-否；1-是，这时参数中产品不是联盟的产品，

    "total_results": "561",  #表示总数有561笔产品

    "result_list": [

            {

                "category_id": "50010421",

                "conpon_info": "满100元减10元",  //优惠券面额从这提取，格式固定是"满xx元减yy元"

                ...... //搜索产品字段

              }

         ]

}

2、产品定向搜索：

使用场景：

当参数是指定产品的ID、淘口令、链接，并且没有强制只搜索产品标题时（onlysearch参数为1）

返回值（search_type和 data 字段不同）：

这时 data返回值和高佣转链返回值是一致的。

{

    "error": "0",

    "msg": "查询成功！本次搜索直接转链产品",

    "search_type": "2", # 1表示搜索产品关键字，2表示转链

    "is_similar":"0",   # 是否找相似搜索，在这里定向搜索时，本字段无意义。

    "result": 2,

    "data": {

        "category_id": "50013864",

         "conpon_info": "满100元减10元",  //优惠券面额从这提取，格式固定是"满xx元减yy元"

          .... //转链的各种值

     }

}

3、当没有返回值，或出错时，返回值如下：

{

    "error": "15",

    "msg": "50001: 淘宝服务器没有返回结果",

    "search_type": "1"

}

四、超级搜索接口的其它参数：

因为搜索API有以下两种功能（定向搜索和泛搜索），因此参数需要pid等，参数说明如下：

（1）当搜索接口super触发定向搜索的转链功能时，它的参数和万能转链接口一致，因此，需要提供pid等参数。详情参数http://wsd.591hufu.com/doc 

比较重要的有：

1、pid 参数： 必选，至少提供一个默认的PID参数，当搜索接口触发转链功能时，会用到。最好是渠道PID

2、relationId 参数：可选，当搜索接口触发转链时，此渠道ID参数将做为转链参数。

其它转链场景（返回值中search_type值为2）请参考万能转链接口hcapi的参数。

（2）当仅搜索产品列表时，此super接口参数如下（均为非必须参数）：

1、page 参数：传递当前页码值。默认1.

2、pagesize 参数：传递每页最大显示数，默认15，最大值不要超过30.

3、coupon 参数：当不传递coupon参数或coupon=0时，默认搜索包含无券产品，当传coupon=1时则搜索有券产品。

4、start_price 和 end_price 参数：start_price 指折扣价范围下限，end_price 指折扣价范围上限，单位：元

5、start_tk_rate 和 end_tk_rate 参数：end_tk_rate，淘客佣金比率上限，如：1234表示12.34%，start_tk_rate淘客佣金比率下限

6、is_overseas 参数：是否海外商品，is_overseas=1 指定为海外产品。默认为否。

7、is_tmall 参数：是否商城商品，默认0（可选0或1），设为1表示商品是天猫商城商品，不设置或0表示不限制。

8、cat 参数： 淘宝分类类目ID，用,分割，最大10个，该ID可以通过taobao.itemcats.get接口获取到。当传递了cat参数时，可以不必使用para参数，比如：

       http://apis.vephp.com/super?vekey=xxxxx&cat=50011129

9、sort 参数：排序，默认 total_sales_des（销量降序），可选值如下：

        tk_rate_des（淘客佣金比率降序）, 

        tk_rate_asc（淘客佣金比率升序）,  

        total_sales_des（销量降序）, 

        total_sales_asc（销量升序）,  

        tk_total_sales_des（累计推广量降序）, 

        tk_total_sales_asc（累计推广量升序）,   

        tk_total_commi_des（总支出佣金降序）, 

        tk_total_commi_asc（总支出佣金升序）, 

        price_des（价格降序）,

        price_asc（价格升序）;

10、onlysearch 参数（强制仅使用搜索）：可选，当指定 onlysearch=1 时，如果para参数是“淘口令、产品ID、二合一等各种淘宝链接”时，本接口默认是会直接把参数转入高佣API，得到该参数对应的产品推广详情和淘口令。但是指定“onlysearch=1”后，接口会把para参数中淘口令等解析后取得它对应的产品标题，并且它的标题去搜索，而不会进行高佣转链。

11、similar 参数：可选值0和1（默认值0），是指自动使用找相似功能。默认是不找相似。当搜索中指定该参数为1时，则自动在发现非联盟产品时使用找相似功能。这时，返回值中字段 is_similar 表示是否为相似搜索，is_similar值为1表示近似产品搜索。

12、searchid 参数：可选值0和1（默认值0），是指搜索产品ID，此时参数para必须是淘宝产品ID，使用本参数时，onlysearch和similar同时失效。这时返回的是该ID的产品搜索结果，而非定向转链接口。

13、ip 参数： 当需要限制包邮时，最好传递顾客的IP参数，比如：  ip=122.71.37.32 ，本参数最好和freeship一起使用。

14、freeship参数：是否只查包邮产品，默认值不限。如果只想要包邮产品，可以传递freeship=1

15、npx 参数： 默认不设置。此参数指定牛皮癣程度，此参数影响主图美观度，可用取值范围：1-不限，2-无，3-轻微