Api列表 / 超级搜索
    目录
    1. 二合一高佣转链
    2. 社群精编文案
    3. 生成淘口令
    1. 二合一高佣转链
    2. 生成淘口令
    1. 社群精编文案
    2. 微信线报数据素材
    3. 商品搜索
    4. 超级搜索
    5. 商品列表
    6. 商品筛选
    1. 9.9包邮精选商品
    2. 20元包邮精选商品
    3. 高佣榜单
    1. 单品详情
    2. 商品详情查询简版(可批量)
    3. 优惠券详情查询
    1. 淘宝官方物料库
    2. 官方活动转链
    1. 店铺转链(可批量)
    2. 淘系click短链接
    3. 解析淘口令

超级搜索
通过主要关键词来获取全网商品信息
  • 接口文档
  • 更新日志

接口说明

用户可以通过传入参数获取全网单个或多个商品信息

公共参数

请求地址

请求方式 GET
请求地址 http://api.tk.net/openapi/super-search
请求示例 http://api.tk.net/openapi/super-search?appkey=你的appkey&keyword=女装

公共请求参数

参数名 类型 是否必须 示例值 说明
appkey string 你的appkey 验证身份凭证

接口请求参数

参数名 类型 是否必须 示例值 说明
keyword string 女装 可以传入商品标题关键词或者商品id
pid number mm_xx_xx_xx 推广位id,mm_xx_xx_xx pid三段式完整版
start_dsr number 10 商品筛选(特定媒体支持)-店铺dsr评分。筛选大于等于当前设置的店铺dsr评分的商品0-50000之间
pagesize number 20 页大小,默认20,1~100
page number 1 第几页,默认:1
platform number 1 链接形式:1:PC,2:无线,默认:1
end_tk_rate number 1234 商品筛选-淘客佣金比率上限。如:1234表示12.34%
start_tk_rate number 1234 商品筛选-淘客佣金比率下限。如:1234表示12.34%
end_price number 10 商品筛选-折扣价范围上限。单位:元
start_price number 10 商品筛选-折扣价范围下限。单位:元
is_overseas boolean false 商品筛选-是否海外商品。true表示属于海外商品,false或不设置表示不限
is_tmall boolean false 商品筛选-是否天猫商品。true表示属于天猫商品,false或不设置表示不限
sort string tk_rate_des 排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price)
itemloc string 杭州 商品筛选-所在地
material_id number 2836 不传时默认物料id=2836;如果直接对消费者投放,可使用官方个性化算法优化的搜索物料id=17004
has_coupon boolean false 优惠券筛选-是否有优惠券。true表示该商品有优惠券,false或不设置表示不限
ip string 13.2.33.4 ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供
need_free_shipment boolean true 商品筛选-是否包邮。true表示包邮,false或不设置表示不限
need_prepay boolean true 商品筛选-是否加入消费者保障。true表示加入,false或不设置表示不限
include_pay_rate_30 boolean true 商品筛选(特定媒体支持)-成交转化是否高于行业均值。True表示大于等于,false或不设置表示不限
include_good_rate boolean true 商品筛选-好评率是否高于行业均值。True表示大于等于,false或不设置表示不限
include_rfd_rate boolean true 商品筛选(特定媒体支持)-退款率是否低于行业均值。True表示大于等于,false或不设置表示不限
npx_level number 2 商品筛选-牛皮癣程度。取值:1不限,2无,3轻微
end_ka_tk_rate number 1234 商品筛选-KA媒体淘客佣金比率上限。如:1234表示12.34%
start_ka_tk_rate number 1234 商品筛选-KA媒体淘客佣金比率下限。如:1234表示12.34%
device_encrypt string MD5 智能匹配-设备号加密类型:MD5
device_value string xxx 智能匹配-设备号加密后的值(MD5加密需32位小写)
device_type string IMEI 智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID
lock_rate_end_time number 1567440000000 锁佣结束时间
lock_rate_start_time number 1567440000000 锁佣开始时间
longitude string 121.473701 本地化业务入参-LBS信息-经度
latitude string 31.230370 本地化业务入参-LBS信息-纬度
city_code string 310000 本地化业务入参-LBS信息-国标城市码,仅支持单个请求,请求饿了么卡券物料时,该字段必填。 (详细城市ID见:https://mo.m.taobao.com/page_2020010315120200508)
seller_ids string 1,2,3,4 商家id,仅支持饿了么卡券商家ID,支持批量请求1-100以内,多个商家ID使用英文逗号分隔
special_id string 2323 会员运营ID
relation_id string 3243 渠道关系ID,仅适用于渠道推广场景

返回示例

参数名 类型 示例值 说明
code number 1 请求成功返回1,请求失败返回0
msg String 获取成功 接口返回接口的描述
cid number 1 1女装,2男装,3内衣,4美妆,5配饰,6鞋品,7箱包,8儿童,9母婴,10居家,11美食,12数码,13家电,14其他,15车品,16文体,17宠物
tid Number 623922534434 商品id
live Number 1 是否直播
bid String 33467 是否品牌
isbm Number 1 是否报名商品
stitle String 【拍两件】韩后小红帽乳糖酸原液15ml 短标题
title String 韩后小红帽乳糖酸原液收缩毛孔面部精华液果酸去黑头毛孔粗大修复 淘宝标题
intro String 【拍两件88元】超值秒杀!韩后乳糖酸精华液,面部精华补水保湿、提亮肤色,超好用的精华原液,修复收缩毛孔,抓紧下单! 商品介绍
tag String 商品标签
nick String 南极人唯欲专卖店 店铺掌柜名
nickid number 3162813958 店主的userid
shopname String hanhoo韩后旗舰店 店铺名
shopid String 1664976033 店铺id
img_url String https://img.alicdn.com/imgextra/i4/1664976033/O1CN01zk59qW1uRA4i5SNYo_!!1664976033.jpg 宝贝主图原始图像
img_arr String http://img.alicdn.com/imgextra/i2/2200771516713/O1CN01Y5ytAN1zSbPsZwPvb_!!2200771516713.jpg,http://img.alicdn.com/imgextra/i1/2200771516713/O1CN01rifvC11zSbPRlS40g_!!2200771516713.jpg,http://img.alicdn.com/imgextra/i3/2200771516713/O1CN01BweHD61zSbPPHzEnT_!!2200771516713.jpg,http://img.alicdn.com/imgextra/i2/2200771516713/O1CN014Xam3s1zSbPVxaX77_!!2200771516713.jpg,http://img.alicdn.com/imgextra/i4/2200771516713/O1CN01Mc48Qw1zSbPJNvlQc_!!2200771516713.jpg 推广长图
price number 29.9 在售价
yprice String 16.9 宝贝券后价
coupon_click_url string https://uland.taobao.com/quan/detail?sellerId=765519661&activityId=941c4c2c89974674978c8d5bce1333be 优惠券链接
coupon_price number 3 优惠券金额
tktype string 通用计划 佣金计划:隐藏 营销
tkrates number 30 佣金比例
volume number 15998 宝贝月销量
todaysale number 24 当天销量
coupon_type string 1 活动类型:1普通活动 2聚划算 3淘抢购
couponreceive2 number 2000 优惠券领取量
couponsurplus number 98000 优惠券剩余量
couponnum number 100000 优惠券总数量
couponexplain string 61.0 优惠券使用条件
couponstarttime number 1602518400 优惠券开始时间(时间戳)
couponendtime number 1602777599 优惠券结束时间(时间戳)
shop_type number B 店铺类型:天猫(B)淘宝店(C)
add_time number 入库时的时间
seller_name number 阿波罗联盟 放单人名号

正确返回结果

返回示例


                                

错误返回结果

错误返回说明

错误码 错误信息 解决方案
0 接口请求失败 检查参数或者稍候重试

返回示例