数据接口API

点击获取APKEY

正常 (重构版)高佣转链接API(淘口令)


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

使用说明

原接口输出数据格式:

{"result":{"data":{"category_id":"16","coupon_click_url":"https://uland.taobao.com/coupon/edetail?e=xxxxHRZPRJiZ3g",…………}},"request_id":"7tbkmlyhcy12","code":200}


重构版接口输出数据格式:

{"code":200,"data":{"category_id":21,"coupon_click_url":"https://uland.taobao.com/coupon/edetail?e=0xxxxxIv4jA",…………},"msg":"success"}


变化点为去除了下面标红部分:(所有高佣转链接口的数据格式修改方式均一致)

 {"result":{"data":{"category_id":"16","coupon_click_url":"https://uland.taobao.com/coupon/edetail?e=+YFbsTxxxxxXKHRZPRJiZ3g",…………}},"request_id":"7tbkmlyhcy12","code":200} 

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 基础设置 中查看APKEY密钥(*必要
tpwdcodeString¥kLBzb1kuO64¥任意淘口令
pidStringmm_0000_0000_000推广位ID(必须是授权淘宝号下的推广位)
activityidString7d6e6619ff754e1e94ea140e2a82240f阿里妈妈推广券ID
tbnameStringxxxxx在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页
relationidString100渠道关系ID,仅适用于渠道推广场景(选填)当入参relationId的时候,必须确保adzoneid为对应合作方账号下的专属pid。后台会进行专属pid和relationId进行校验,校验通过才可以正常推广结算。
shorturlString1是否需要短链接,1为生成,不填则不生成
tpwdString1是否生成淘口令,1为生成,不填则不生成
tpwdpicString商品图片链接,用于打开口令时显示,不填写默认为商品主图
extsearchNumber1官方查不到券时是否去第三方平台查询,1为启用
hasiteminfoString0是否输出商品信息,双十一期间不建议启用,1=启用,0=不启用

返回参数

返回参数类型参数说明扩展说明
short_urlString短链接商品有优惠券时,短链接打开为二合一链接页面,无优惠券时,口令打开为商品页面(注:均为高佣金淘客链接,购买之后均有佣金)
tpwdString淘口令商品有优惠券时,口令打开为二合一链接页面,无优惠券时,口令打开为商品页面(注:均为高佣金淘客链接,购买之后均有佣金)
item_urlString商品淘客链接同样为高佣,has_coupon为false时,建议使用此链接
max_commission_rateString高佣金比例计划中的最高佣金,如果阿里妈妈帐户为初级,则会走通用佣金
item_idNumber商品ID
coupon_click_urlString二合一链接
has_couponString是否有优惠券true,有;false,没有
coupon_typeNumber优惠券类型1 公开券,2 私有券,3 妈妈券
coupon_start_timeString优惠券开始时间没有优惠券,则此项不显示
coupon_total_countString优惠券总量没有优惠券,则此项不显示
coupon_remain_countString优惠券剩余量没有优惠券,则此项不显示
coupon_infoString优惠券信息没有优惠券,则此项不显示
coupon_end_timeString优惠券有效期截止日期没有优惠券,则此项不显示
category_idNumber商品分类ID
youhuiquanNumber优惠券面额没有优惠券则不显示此字段
quanlimitNumber优惠券使用条件优惠券使用限制条件,即满xx元使用

Json返回示例

{"code":200,"data":{"category_id":50013886,"coupon_click_url":"https://uland.taobao.com/coupon/edetail?e=hmIte5suv4cGQASttHIxxxxxxxxw","coupon_end_time":"2019-11-16","coupon_info":"满12元减5元","coupon_remain_count":98000,"coupon_start_time":"2019-11-14","coupon_total_count":100000,"coupon_type":3,"item_id":572497732194,"item_url":"https://s.click.taobao.com/t?e=m=2&s=KpCMqSxxxxxxxw","max_commission_rate":"6.00","item_info":{"cat_leaf_name":"毛巾","cat_name":"户外/登山/野营/旅行用品","item_url":"https://detail.tmall.com/item.htm?id=572497732194","material_lib_type":"1,2","nick":"蓓安适旗舰店","num_iid":572497732194,"pict_url":"https://img.alicdn.com/bao/uploaded/i4/642944409/O1CN011DfWoK1iRMpErNsqD_!!0-item_pic.jpg","presale_deposit":"0","presale_end_time":0,"presale_start_time":0,"presale_tail_end_time":0,"presale_tail_start_time":0,"provcity":"上海","reserve_price":"34","seller_id":642944409,"small_images":{"string":["https://img.alicdn.com/i4/642944409/O1CN01s74Bfa1iRMki8AV1p_!!642944409.jpg","https://img.alicdn.com/i3/642944409/O1CN01JLMtav1iRMoDc1d4p_!!642944409.jpg","https://img.alicdn.com/i2/642944409/O1CN01lqPIaU1iRMkfKkhtQ_!!642944409.jpg","https://img.alicdn.com/i4/642944409/O1CN01628EWw1iRMnGcloFU_!!642944409.jpg"]},"title":"蓓安适一次性洗脸巾女纯棉压缩毛巾浴巾旅行酒店便携床单被罩枕套","tmall_play_activity_end_time":0,"tmall_play_activity_start_time":0,"user_type":1,"volume":17268,"zk_final_price":"12"},"has_coupon":true,"short_url":"https://s.click.taobao.com/xxxxxxx","tpwd":"¥Jhxxxxlw¥","youhuiquan":"5","quanlimit":"12"},"msg":"success"}

code/http_status说明

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