淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟

数据接口API

点击获取APKEY

正常 高佣转链接API(商品ID) 接口在线测试

支持无优惠券宝贝请求,请求高佣前请先授权,并确保传的pid归属于授权的淘宝号下,避免批量请求,本接口不会进行抽佣,请悉知!

接口地址: http://api.web.ecapi.cn/taoke/doItemHighCommissionPromotionLink
接口实例: http://api.web.ecapi.cn/taoke/doItemHighCommissionPromotionLink?apkey=登录会员中心查看&itemid=529048526383&pid=mm_0000_0000_000&tbname=xxx&relation_id=23223
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

暂无说明

请求参数

参数 类型 请求参数参考值 是否必须 说明
apkey String xxxxxxx 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
itemid String 529048526383 宝贝ID
pid String mm_0000_0000_000 推广位ID(*必须是授权淘宝号下的推广位)(注:如已在会员中心设置了默认PID,此参数可无需再次传入)
activityid String 7d6e6619ff754e1e94ea140e2a82240f 阿里妈妈推广券ID
tbname String xxx 在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页
relation_id String 23223 渠道关系ID,仅适用于渠道推广场景(选填)当入参relationId的时候,必须确保adzoneid为对应合作方账号下的专属pid。后台会进行专属pid和relationId进行校验,校验通过才可以正常推广结算,获取说明:https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639(注:如已在会员中心设置了默认渠道ID,此参数可无需再次传入)
shorturl Number 1 是否需要短链接,1为生成,不填则不生成
tpwd Number 1 是否生成淘口令,1为生成,不填则不生成
tpwdpic String 商品图片链接,用于打开口令时显示,不填写默认为商品主图
extsearch Number 1 官方查不到券时是否去第三方平台查询,1为启用
hasiteminfo String 0 是否输出商品信息,双十一期间不建议启用,1=启用,0=不启用
special_id String 会员运营ID
external_id String 淘宝客外部用户标记,如自身系统账户ID;微信ID等
xid String xxxx 团长与下游渠道合作的特殊标识,用于统计渠道推广效果
qrcode String 1 是否生成二维码图片,1是生成,其他或不填则不生成
platform Number 1 1:PC,2:无线,默认:1
get_topn_rate Number 1 是否获取前N件佣金 ,0-否,1-是,其他值-否
mini_program_link Number 0 是否需要获取小程序链接,需要设置1。(暂未对外开放)
promotion_type Number 1-自购省,2-推广赚(代理模式专属ID,代理模式必填,非代理模式不用填写该字段)
biz_scene_id String 1 1-动态ID转链场景,2-消费者比价场景,3-商品库导购场景(不填默认为1)

返回参数

返回参数 类型 参数说明 扩展说明
category_id Number 商品分类ID
coupon_end_time String 优惠券有效期截止日期 没有优惠券,则此项不显示
coupon_info String 优惠券信息 没有优惠券,则此项不显示
coupon_remain_count String 优惠券剩余量 没有优惠券,则此项不显示
coupon_total_count String 优惠券总量 没有优惠券,则此项不显示
coupon_start_time String 优惠券开始时间 没有优惠券,则此项不显示
coupon_type Number 优惠券类型 1 公开券,2 私有券,3 妈妈券
has_coupon String 是否有优惠券 true,有;false,没有
coupon_click_url String 二合一链接
item_id String 商品ID
max_commission_rate String 高佣金比例 当不入参special_id、relation_id、external_id时,展示常规佣金率(%)
item_url String 商品淘客链接 同样为高佣,has_coupon为false时,建议使用此链接
tpwd String 淘口令 商品有优惠券时,口令打开为二合一链接页面,无优惠券时,口令打开为商品页面(注:均为高佣金淘客链接,购买之后均有佣金)
short_url String 短链接 商品有优惠券时,短链接打开为二合一链接页面,无优惠券时,口令打开为商品页面(注:均为高佣金淘客链接,购买之后均有佣金)
youhuiquan Number 优惠券面额 没有优惠券则不显示此字段
quanlimit Number 优惠券使用条件 优惠券使用限制条件,即满xx元使用
item_info Json 商品信息列表
mm_coupon_remain_count String 妈妈优惠券剩余量
mm_coupon_total_count String 妈妈优惠券总量
mm_coupon_click_url String 商品妈妈优惠券推广链接
mm_coupon_end_time String 妈妈优惠券结束时间
mm_coupon_start_time String 妈妈优惠券开始时间
mm_coupon_info String 妈妈优惠券面额
ysyl_click_url String 预售有礼-推广链接
ysyl_tlj_face String 预售有礼-预估淘礼金(元)
ysyl_tlj_send_time String 预售有礼-淘礼金发放时间
ysyl_commission_rate String 预售有礼-佣金比例(%) 预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376
ysyl_tlj_use_start_time String 预售有礼-淘礼金使用开始时间
ysyl_tlj_use_end_time String 预售有礼-淘礼金使用结束时间
min_commission_rate String 当入参special_id、relation_id、external_id时,该字段展示预估最低佣金率(%)
qrcode String 二维码图片,有优惠券时为二合一,没有优惠券时为商品单链接 可选参数
reward_info String 比价场景专用,当系统检测到入参消费者ID购买当前商品会获得《天天开彩蛋》玩法的彩蛋时,该字段显示1,否则为0
topn_info Json 前N件佣金信息 当入参get_topn_rate=1,前N件佣金生效且最高,透出该组字段
 ├ topn_total_count Number 前N件初始总库存,当前N件佣金失效,本字段置空(失效:任务完成、时间结束、商品下架)
 ├ topn_quantity String 前N件剩余库存,当前N件佣金失效,本字段置空
 ├ topn_start_time String 前N件佣金开始时间,当前N件佣金失效,本字段置空
 ├ topn_end_time String 前N件佣金结束时间, 当前N件佣金 失效,本字段置空
mini_program Json 小程序链接(暂未对外开放)
 ├ mini_program_appid String 小程序APPID
 ├ mini_program_path String 小程序路径
 ├ mini_program_qrcode_url String 小程序码url地址

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 数据获取失败
401 IP没有添加白名单
429 访问次数超限
403 关键参数丢失
405 请求方式不对