数据接口API

点击获取APKEY

正常 (重构版)获取全网淘客商品API


请求链接: http://api.web.21ds.cn/taoke/getTkMaterialItem
请求实例: http://api.web.21ds.cn/taoke/getTkMaterialItem?apkey=登录后即可显示&pid=mm_123456_456789_789132&tbname=xxxxx (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】进行Urlencode编码,然后再试。
今日调用统计: 暂无统计
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 获取淘客推广商品
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 >立即抢购<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 基础设置 中查看APKEY密钥(*必要
pidStringmm_123456_456789_789132淘宝联盟PID
tbnameStringxxxxx在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页
startdsrString100店铺dsr评分,筛选高于等于当前设置的店铺dsr评分的商品0-50000之间
pagesizeString100每页数据多少条,1~100
pagenoString1第几页
platformString2链接形式:1:PC,2:无线,默认:1
endtkrateString1234淘客佣金比率上限,如:1234表示12.34%
starttkrateString1000淘客佣金比率下限,如:1234表示12.34%
endpriceString10折扣价范围上限,单位:元
startpriceString1折扣价范围下限,单位:元
isoverseasString是否海外商品,设置为true表示该商品是属于海外商品,设置为false或不设置表示不判断这个属性
istmallString是否商城商品,设置为true表示该商品是属于淘宝商城商品,设置为false或不设置表示不判断这个属性
sortString排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price)
itemlocString所在地
catString后台类目ID,用,分割,最大10个,该ID可以通过taobao.itemcats.get接口获取到,或者加我们官方群,在群文件中有整理过的分类文件
keywordString女装查询词,可直接传入商品链接进行精准搜索,或者使用高佣转链接口进行搜索:http://open.21ds.cn/index/index/openapi/id/1.shtml?ptype=1
hascouponString是否有优惠券,设置为true表示该商品有优惠券,设置为false或不设置表示不判断这个属性
ipString13.2.33.4ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供
includerfdrateStringtrue退款率是否低于行业均值
includegoodrateStringtrue好评率是否高于行业均值
includepayrateStringtrue成交转化是否高于行业均值
needprepayStringtrue是否加入消费者保障,true表示加入,空或false表示不限
needfreeshipmentStringtrue是否包邮,true表示包邮,空或false表示不限
npxlevelString3牛皮癣程度,取值:1:不限,2:无,3:轻微
end_ka_tk_rateNumber1234KA媒体淘客佣金比率上限,如:1234表示12.34%
start_ka_tk_rateNumber1234KA媒体淘客佣金比率下限,如:1234表示12.34%
device_valueString设备号加密后的值
device_encryptStringMD5设备号加密类型:MD5
device_typeStringIMEI设备号类型:IMEI,或者IDFA,或者UTDID
material_idNumber2836官方的物料Id(详细物料id见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576096),不传时默认为2836

返回参数

返回参数类型参数说明扩展说明
totalcountNumber搜索到符合条件的结果总数
dataJson商品列表
 ├ coupon_start_timeString优惠券开始时间
 ├ coupon_end_timeString优惠券结束时间
 ├ info_dxjhString定向计划信息
 ├ tk_total_salesNumber淘客30天月推广量
 ├ tk_total_commiString月支出佣金
 ├ coupon_idString优惠券id如果没有优惠券,则无
 ├ num_iidString宝贝id
 ├ titleString商品标题
 ├ pict_urlString商品主图
 ├ small_imagesJson商品小图列表
 ├ reserve_priceString商品一口价格
 ├ zk_final_priceString商品折扣价格
 ├ user_typeString卖家类型0表示集市(淘宝店铺),1表示商城(天猫商城)
 ├ provcityString宝贝所在地
 ├ item_urlString商品地址
 ├ include_mktString是否包含营销计划包含:true,否则为false
 ├ include_dxjhString是否包含定向计划包含:true,否则为false
 ├ commission_rateString佣金比率如返回1000,佣金比例则为10%
 ├ volumeNumber30天销量
 ├ seller_idNumber卖家id
 ├ coupon_total_countNumber优惠券总量
 ├ coupon_remain_countNumber优惠券剩余量
 ├ coupon_infoString优惠券信息
 ├ commission_typeString佣金类型MKT表示营销计划,SP表示定向计划,COMMON表示通用计划
 ├ shop_titleString店铺名称
 ├ urlString商品淘客链接
 ├ coupon_share_urlString券二合一页面链接
 ├ shop_dsrString店铺dsr评分
 ├ quanlimitNumber优惠券使用条件,如:满XX元使用如果没有优惠券则无此字段
 ├ youhuiquanNumber优惠券面额如果没有优惠券则无此字段

Json返回示例

{"code":200,"data":{"commission_rate":"2010","commission_type":"MKT","coupon_end_time":"2018-08-15","coupon_id":"eec387cc687f42c0aa1fa38b029877dd","coupon_info":"满11.00元减2元","coupon_remain_count":"98524","coupon_share_url":"//uland.taobao.com/coupon/edetail?e=hlrfAnQbsoMGQASttHIRqVvG+XKzZl0u5LBodTDpKuvoEnMr9v+wai7tBIKWCr05a7E1JQXqpN8SMYg4guO+wrSYQHFTmwpo/zrmtpFY67E=&app_pvid=0b085fb715342188963218875d0a96&ptl=floorId:2836;app_pvid:0b085fb715342188963218875d0a96;tpp_pvid:100_11.182.80.102_120338_9351534218896333392&mt=1&union_lens=lensId:0b0ad011_08fe_1653692844f_7feb","coupon_start_time":"2018-08-08","coupon_total_count":"100000","include_dxjh":"true","include_mkt":"true","info_dxjh":"{"66093912":"1300","43404796":"1500","47827517":"1500"}","item_url":"/","num_iid":"532530634044","pict_url":"https://img.alicdn.com/bao/uploaded/i2/TB16msZPVXXXXXWapXXXXXXXXXX_!!0-item_pic.jpg","provcity":"广东 广州","reserve_price":"69","seller_id":"2451796575","shop_title":"凯恒千色旗舰店","small_images":{"string":["https://img.alicdn.com/i1/2451796575/TB2aG7ajctnpuFjSZFKXXalFFXa_!!2451796575.jpg","https://img.alicdn.com/i4/2451796575/TB2wUUEaOpnpuFjSZFkXXc4ZpXa_!!2451796575.jpg","https://img.alicdn.com/i1/2451796575/TB2fu1YpxlmpuFjSZPfXXc9iXXa_!!2451796575.jpg","https://img.alicdn.com/i1/2451796575/TB2NLosawNlpuFjy0FfXXX3CpXa_!!2451796575.jpg"]},"title":"夏季韩版日系男士T恤男短袖圆领修身体恤半袖衣服男装打底衫潮流","tk_total_commi":"76811.8","tk_total_sales":"28425","url":"//s.click.taobao.com/t?e=m=2&s=VspdImZHPJtw4vFB6t2Z2ueEDrYVVa64RZKDdhY4Y8EYX8TY+NEwd2jaNSAsMc210e71iVTN2Ryo7dWog3ebVdT7lkKmU81dohUZ5MRF2GoQpBoOCk4Z2Z9jgTHG5ey4UjUt9VEiF8TFF4C67BPYpaTRYuuZT+/4Lc2DFJhTmEY=&scm=null&pvid=100_11.182.80.102_120338_9351534218896333392&app_pvid=0b085fb715342188963218875d0a96&ptl=floorId:2836;pvid:100_11.182.80.102_120338_9351534218896333392;app_pvid:0b085fb715342188963218875d0a96&union_lens=lensId:0b0ad011_08fe_1653692844f_7feb","user_type":"1","volume":"69475","zk_final_price":"11.9"},"totalcount":"20900","msg":"淘客商品获取成功"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对