淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
点击获取APKEY

正常 全网淘客商品查询API

更新时间:2020-09-03 12:39:51

请求链接: http://api.web.ecapi.cn/taoke/getTkMaterialItem
请求实例: http://api.web.ecapi.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或不设置表示不判断这个属性
sortStringtotal_sales_des排序_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
ver_codeNumber101接口数据版本,不传或传100为默认版,101为新版,带有商品数量统计,数据格式与默认版不同,需注意
lock_rate_end_timeString1567440000000锁佣结束时间
lock_rate_start_timeString1567440000000锁佣开始时间
seller_idsString商家id,仅支持饿了么卡券商家ID,支持批量请求1-100以内,多个商家ID使用英文逗号分隔
city_codeString本地化业务入参-LBS信息-国标城市码,仅支持单个请求,请求饿了么卡券物料时,该字段必填。 (详细城市ID见:https://mo.m.taobao.com/page_2020010315120200508)
latitudeString31.230370本地化业务入参-LBS信息-纬度
longitudeString121.473701本地化业务入参-LBS信息-经度
relation_idString渠道关系ID,仅适用于渠道推广场景
special_idString会员运营ID

返回参数

返回参数类型参数说明扩展说明
totalcountNumber搜索到符合条件的结果总数
dataJson商品列表
 ├ coupon_start_timeString优惠券开始时间
 ├ coupon_end_timeString优惠券结束时间
 ├ info_dxjhString定向计划信息
 ├ tk_total_salesNumber淘客30天月推广量
 ├ tk_total_commiString月支出佣金
 ├ coupon_idString优惠券id如果没有优惠券,则无
 ├ item_idString宝贝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优惠券面额如果没有优惠券则无此字段
 ├ white_imageString商品信息-商品白底图
 ├ short_titleString商品信息-商品短标题
 ├ category_idString商品信息-叶子类目id
 ├ category_nameString商品信息-叶子类目名称
 ├ level_one_category_idString商品信息-一级类目ID
 ├ level_one_category_nameString商品信息-一级类目名称
 ├ oetimeString拼团专用-拼团结束时间
 ├ ostimeString拼团专用-拼团开始时间
 ├ jdd_numString拼团专用--拼团几人团
 ├ jdd_priceString拼团专用-拼团拼成价,单位元
 ├ uv_sum_pre_saleString预售专用-预售数量
 ├ coupon_amountString优惠券(元) 若属于预售商品,该优惠券付尾款可用,付定金不可用
 ├ coupon_start_feeString优惠券信息-优惠券起用门槛,满X元可用,如:满299元减20元
 ├ item_descriptionString宝贝描述(推荐理由)
 ├ nickString店铺信息-卖家昵称
 ├ x_idString链接-物料块id(测试中请勿使用)
 ├ orig_priceString拼团专用-拼团一人价(原价),单位元
 ├ total_stockString拼团专用-拼团库存数量
 ├ sell_numString拼团专用-拼团已售数量
 ├ stockString拼团专用-拼团剩余库存
 ├ tmall_play_activity_infoString营销-天猫营销玩法
 ├ real_post_feeString商品邮费
 ├ lock_rate_start_timeString锁佣开始时间
 ├ lock_rate_end_timeString锁佣结束时间
 ├ lock_rateString锁住的佣金率
 ├ presale_discount_fee_textString预售商品-优惠信息
 ├ presale_tail_end_timeString预售商品-付尾款结束时间(毫秒)
 ├ presale_tail_start_timeString预售商品-付尾款开始时间(毫秒)
 ├ presale_end_timeString预售商品-付定金结束时间(毫秒)
 ├ presale_start_timeString预售商品-付定金开始时间(毫秒)
 ├ presale_depositString预售商品-定金(元)
 ├ ysyl_tlj_send_timeString预售有礼-淘礼金发放时间
 ├ ysyl_click_urlString预售有礼-推广链接
 ├ ysyl_commission_rateString预售有礼-佣金比例预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376
 ├ ysyl_tlj_faceString预售有礼-预估淘礼金(元)
 ├ ysyl_tlj_use_end_timeString预售有礼-淘礼金使用结束时间
 ├ ysyl_tlj_use_start_timeString预售有礼-淘礼金使用开始时间
 ├ usable_shop_nameString本地化-可用店铺名称
 ├ usable_shop_idString本地化-可用店铺id
 ├ distanceString本地化-到门店距离(米)
 ├ sale_end_timeString本地化-销售开始时间
 ├ sale_begin_timeString本地化-销售结束时间
 ├ sale_priceString活动价
 ├ kuadian_promotion_infoString跨店满减信息

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请求方式不对