在线
客服
会员请加QQ群交流：
微信
咨询
加微信咨询
淘宝客产品超级搜索接口，只为更好帮您把握每一次成交机会！
此新版淘宝联盟超级搜索接口，用于替代已运行几年的旧版的super淘客超级搜索接口。即保持了原有搜索接口优点。又简化了接口逻辑。
此次新版搜索接口专注于搜索功能。旧版搜索接口仍然保留，原则上不再更新。强烈推荐使用此新版淘宝客商品超级搜索接口。
（一）保持并强化了原有的搜索接口特性：
1、【强大的参数处理能力】接收五花八门的关键字进行泛搜索，获取产品列表。经近3年的升级，可处理各种非常规关键字。
2、【定向搜索】当您的客户使用从手淘等处复制的淘口令/喵口令、五花八门链接等内容。接口直接返回商品信息。
3、【优惠券保持和店铺券搜索】当您要搜索指定商品在联盟官方中没有优惠券，而参数中有券，则接口会保持商品的券，并可以搜索该商品可用的店铺券。
4、【找相似功能】当查找淘宝联盟以外的商品时，普通搜索无法获取结果，而本接口独有淘宝联盟官方APP一样的“找相似”功能可以增加用户成交机会。
5、【完全高佣】搜索获取的产品全部显示高佣，方便您在应用中准确计算分享给客户的佣金金额。
6、【APP上架帮助】苹果系统APP上架和微信小程序需要过滤虚拟产品，搜索接口提供了虚拟产品过滤功能，帮助您顺利上架。
7、【精准提词功能】有时搜索标题关键字在搜索时，淘宝无返回值或不准确，此时本接口将触发维易全网独有的标题精准提词功能，精准分析用户搜索意向产品，返回搜索结果。比如“95%绒子羽绒被白鹅绒被蓬松羽绒被芯被子”搜索词，联盟官方接口上返回的是宠物玩具、丝袜等不相关词，而维易接口有提词功能介入，可以得到“羽绒被”结果。
又如“大琳手作 复古摩登中式气质屏风原创设计防过敏银耳钉耳夹无耳洞”，市场上的APP基本搜索结果都是毫不相关的“屏风”产品，而不是“银耳钉”，使用维易接口可以得到正确耳钉结果。
参考“电商标题提取产品词接口”：http://wsd.591hufu.com/doc/biaotijingzhuntici
（二）精简了原有搜索接口super的逻辑和功能：
更专注，更简单，更好用，是这次接口改版的方向。
1、新接口去掉了原接口的定向搜索中的默认“转链”功能，让返回值保持统一，如果您需要返回值中同时处理转链，则需要指定tklink参数。
2、接口逻辑（在返回值 search_type 字段中获得状态）：
（A）当提供淘口令，链接或产品ID等带指定商品信息的参数时，且这个商品是“淘客商品”时，会直接返回该商品的信息。此时允许搜索商品可用店铺券。
（B）当提供参数是指定商品，但该商品是非淘客商品，则会直接返回“相似”商品。
（C）当提供关键字时，则直接根据关键字搜索。并在适当情形下触发精准提词功能，使搜索结果更精准。
【接口地址】
http://api.veapi.cn/tbk/tb_search?vekey=xxx¶=xxx
【调用示例】
1、纯关键字搜索：搜索“华为手机”商品：
http://api.veapi.cn/tbk/tb_search?vekey=xxx¶=华为手机
如果需要批量转链，加tklink参数：
http://api.veapi.cn/tbk/tb_search?vekey=xxx¶=华为手机&tklink=1
2、搜索ID为"651196798743"的淘客商品：
http://api.veapi.cn/tbk/tb_search?vekey=xxx¶=651196798743
3、搜索淘口令￥AhfTXBYmdex￥的商品：
http://api.veapi.cn/tbk/tb_search?vekey=xxx¶=￥AhfTXBYmdex￥
(参数para和万能转链接口一样，可以处理任何淘客参数。比如手淘分享出来的原始文案)
4、搜索商品分类为“1512”的商品：
http://api.veapi.cn/tbk/tb_search?vekey=xxx&cat=1512
【接口参数】
接口参数基本和旧版super接口一致，但部分参数作用有不同，比如similar参数。
1、vekey：必选，您在维易会员中的授权后生成的密钥。
2、para：主参数，可以是产品ID，淘宝链接，淘口令，淘客链接等。
3、cat：可选，商品分类ID。用于搜索该类别的淘客商品。cat和para参数不可同时为空。
4、page 可选，参数：传递当前页码值。默认1.
5、pagesize 可选，参数：传递每页最大显示数，默认15，最大值不要超过30.
6、deepcoupon参数，可选值0或1：指是否要搜索商品的店铺券，值为1时搜索para指定的商品的店铺券，仅当para参数为指定商品时有效（淘口令，商品链接，ID等）；
7、coupon 参数：当不传递coupon参数或coupon=0时，默认搜索包含无券产品，当传coupon=1时则搜索有券产品。
8、virtual 参数，可选值0，1，2，用于指定是否过滤或检测虚拟类产品，苹果APP或微信小程序上架时需要用到，可临时开启，参数值：默认0表示不检查虚拟类商品，1表示检测并拒绝虚拟类商品搜索（此时接口error为91），2表示只检测不过滤，这时返回值中增加一个字段is_virtual（值0表示不是虚拟产品，1表示是虚拟产品）
9、similar 可选，参数：值0和1（默认值0），是指自动使用找相似功能。仅当接口搜索指定商品ID时有效（默认此时只返回指定商品信息，当指定similar=1时，则同时返回该商品近似商品）。
10、start_price 和 end_price 参数：start_price 指折扣价范围下限，end_price 指折扣价范围上限，单位：元
11、start_tk_rate 和 end_tk_rate 参数：end_tk_rate，淘客佣金比率上限，如：1234表示12.34%，start_tk_rate淘客佣金比率下限，注意是千位表示法，比如要限制佣金是10%，则start_tk_rate=1000而不是start_tk_rate=10
12、is_overseas 参数：是否海外商品，is_overseas=1 指定为海外产品。默认为否。
13、is_tmall 参数：是否商城商品，默认0（可选0或1），设为1表示商品是天猫商城商品，不设置或0表示不限制。
14、sort 参数：排序，默认 total_sales_des（销量降序），可选值如下：
global （综合排序）
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（价格升序）;
15、ip 参数： 当需要限制包邮时，最好传递顾客的IP参数，比如： ip=122.71.37.32 ，本参数最好和freeship一起使用。
16、freeship 参数：是否只查包邮产品，默认值不限。如果只想要包邮产品，可以传递freeship=1
17、npx 参数： 默认不设置。此参数指定牛皮癣程度，此参数影响主图美观度，可用取值范围：1-不限，2-无，3-轻微
18、relation_id参数（可选）：渠道关系ID，仅适用于渠道推广场景，如2566221。
19、special_id参数（可选）：会员运营ID。
20、tklink参数（可选）：如果您需要搜索接口直接生成推广链接，请添加本参数，以确保返回 item_id、url、coupon_share_url 这三个字段。
21、pid参数（可选）：如果您提供了tklink参数，则必须提供pid参数。
22、force_index 参数（可选）：强制使用标题提词功能（有需要时调用，不要高频使用，影响效率）：有时关键词，比如“95%绒子羽绒被白鹅绒被蓬松羽绒被芯被子”淘宝官方返回全是不相关的宠物玩具等产品，维易接口已做了自动分析返回值，如果不符合自动用“标题提词”功能介入优化搜索，得到正确结果，但有时可能有的词仍然被分析方法漏掉，得到的仍是不准确的结果，这时你可以使用本参数，把相同关键字上次搜索结果的返回值中“force_index”值做为本参数入参，比如“force_index=1600740049_e1142230473”，这样就可以对“相同的关键词”强制使用标题提词功能。
【注意】本参数不能直接使用，要依赖于上次搜索结果返回的force_index字段值，且有时效性。且关键字必须相同。
【使用场景】你可以在你的APP上搜索结果列表上做一个“搜索不准确？”的提示功能，让用户按下后，把前一次的返回值中force_index做为API入参，重新请求一次接口，得到正确结果。
【以下参数按需选用】
1、presale 参数（仅双11期间有效）：默认不设置，可选值1或0，当设置为1时，使用关键字搜索的商品均为双11预售商品。
2、material_id 参数：可选，指定物料ID。当presale参数为1时，本参数失效。
3、include_pay_rate_30 参数（可选）：参数值1或0，商品筛选(特定媒体支持)-成交转化是否高于行业均值。1表示大于等于，0或不设置表示不限
4、include_good_rate 参数（可选）：参数值1或0，商品筛选-好评率是否高于行业均值。1表示大于等于，0或不设置表示不限
5、end_ka_tk_rate 参数（可选）：商品筛选-KA媒体淘客佣金比率上限。如：1234表示12.34%
6、start_ka_tk_rate 参数（可选）：商品筛选-KA媒体淘客佣金比率下限。如：1234表示12.34%
7、device_value 参数（可选）：智能匹配-设备号加密后的值（MD5加密需32位小写）
8、device_encrypt 参数（可选）：智能匹配-设备号加密类型：MD5
9、device_type 参数（可选）：智能匹配-设备号类型：IMEI，或者IDFA，或者UTDID（UTDID不支持MD5加密），或者OAID
10、lock_rate_end_time 参数（可选）：示例值：1567440000000，锁佣结束时间
11、lock_rate_start_time 参数（可选）：示例值：1567440000000，锁佣开始时间
12、seller_ids 参数（可选）：示例值“1,2,3,4”，商家id，仅支持饿了么卡券商家ID，支持批量请求1-100以内，多个商家ID使用英文逗号分隔
13、city_code 参数（可选）：本地化业务入参-LBS信息-国标城市码，仅支持单个请求，请求饿了么卡券物料时，该字段必填。 （详细城市ID见：https://mo.m.taobao.com/page_2020010315120200508）
14、latitude 参数（可选）：本地化业务入参-LBS信息-纬度，如31.230370
15、longitude 参数（可选）：本地化业务入参-LBS信息-经度。如121.473701
16、need_prepay 参数（可选）：参数值1或0，商品筛选-是否加入消费者保障。1表示加入，0或不设置表示不限
17、checksalestatus 参数（可选）：检测商品是否为淘客商品且有效（比如优惠券过期等）。默认值0，当提供的参数中的商品为非淘客或下架时，不再搜索相似商品，直接返回提示下架。
示例：http://api.veapi.cn/tbk/tb_search?vekey=xxxx¶=651196798743&checksalestatus=1 当检查到651196798743为下架或非淘客商品时，直接返回
【接口返回值】
返回值中 search_type 是重要的，和旧版含义有所不同，它指明了本次搜索接口返回值的类型：
0 ：表示未启动搜索，通常有错误时出现。
10 ：表示搜索淘口令或链接参数中的产品，
21和22 ：表示搜索非淘客商品相似商品（21和22的区别仅供调试区分使用，但都表示非淘客商品找相似的结果）
30 ：表示直接搜索关键字。
60 ：其它。
以下是完整返回值结构。
更详细的字段说明参考：http://wsd.591hufu.com/taokelianmeng/201.html
{
"error": "0",
"msg": "查询成功！",
"search_type": 10, //搜索类型：0表示未启动搜索，10表示搜索淘口令或链接中的产品，21和22表示搜索非淘客商品找相似结果，30表示搜索关键字，60其它
"is_similar": "0", //是否是相似搜索：0-否，1-是
"is_splitWord": 0, //是否触发精准提词功能：0-否，1-是
"force_index": "", //取决于is_splitWord类型，参考参数说明。当无提词时，则本参数可能为空。
"total_results": 1, //返回的商品数量。
"result_list": [
{
"category_id": 1512,
"category_name": "手机",
"commission_rate": "200", //佣金率，需要除以100得到百分比例值，比如5000表示50%。这里200表示2%
"coupon_id": "", //优惠券ID，只有有券时才有此参数。
"coupon_info": "", //优惠券信息，比如“满200元减10元”。
"coupon_remain_count": 0, //优惠券余量，如无此字段则表示没有优惠券
"coupon_total_count": 0, //优惠券总量，如无此字段则表示没有优惠券
"cpa_reward_type": "", //额外奖励活动类型，如果一个商品有多个奖励类型，返回结果使用空格分割，0=单单奖励，1=超级单单奖励
"item_description": "",
"item_id": 623346006409,
"item_url": "https://detail.tmall.com/item.htm?id=623346006409",
"level_one_category_id": 1512, //商品信息-一级类目ID
"level_one_category_name": "手机", //商品信息-一级类目名称
"nick": "小米官方旗舰店",
"num_iid": 623346006409,
"pict_url": "https://img.alicdn.com/bao....", //主图
"presale_deposit": "0", //预售商品-定金(元)，通常是双11时才有。
"presale_end_time": 0, //预售商品-付定金结束时间（毫秒）
"presale_start_time": 0, //预售商品-付定金开始时间（毫秒）
"presale_tail_end_time": 0, //预售商品-付定金结束时间（毫秒）
"presale_tail_start_time": 0, //预售商品-付尾款开始时间（毫秒）
"provcity": "北京",
"real_post_fee": "0.00",
"reserve_price": "799.01",
"seller_id": 1714128138,
"shop_dsr": 48735,
"shop_title": "小米官方旗舰店",
"short_title": "【128g购机优惠10元】屏幕小米红米",
"small_images": [
"https://img.alicdn.com/i3/....",
"https://img.alicdn.com/i3/....",
"https://img.alicdn.com/i2/....",
"https://img.alicdn.com/i4/....."
],
"superior_brand": "1", //是否品牌精选，0不是，1是
"title": "【热销爆款】红米9A 5000mAh大...",
"tk_total_commi": "541680.5", //商品信息-月支出佣金(该字段废弃，请勿再用)
"tk_total_sales": "42915",
"coupon_share_url":"//uland.taobao.com/coupon/edetail?..." //淘客推广链接，二合一领券链接。当提供 tklink 参数后才有这个字段
"url": "//s.click.taobao.com/t?e....", //淘客推广链接，不领券链接。当提供 tklink 参数后才有这个字段
"user_type": 1, //店铺信息-卖家类型。0表示集市，1表示天猫
"volume": 72393, //商品信息-30天销量(饿了么卡券信息-总销量）
"white_image": "https://img.alicdn.com/...",
"zk_final_price": "599"
}
]
}
返回值佣金字段说明：
返回值字段佣金比率“commission_rate”需要除以100得到百分比例值，比如5000表示50%。
问：为什么我用关键字调用搜索接口时，返回返回产品列表中某产品佣金率 commission_rate， 和使用该产品的淘口令或链接做参数调用搜索或转链接口时，返回的commission_rate不一样？
答：
因为搜索接口泛搜索时（即使用关键字搜索或非联盟商品找相似搜索），返回的产品列表是按“最高佣金”显示的，方便做返利型APP的在搜索列表展示中直接显示会员可取多少分佣。但是你能否拿到这个最高佣金，要按你的帐户级别，只有高级帐号才可以，如果是初级或中级帐号，就会显示的佣金比例比泛搜索低。所以，只要把帐号升级即可。
可委托本站升级，全过程需要3天时间。请联系客服。