淘宝客高级API
淘宝客高佣转链api(商品id版)
需要授权
26316人使用

通过商品id将普通淘宝商品转换为淘宝客高佣推广链接,并自动查券, 该接口可用于开发各类淘客CMS、公众号、小程序、机器人等应用软件。

如果您的淘宝联盟账号是初级,请升级到高级后再调用高佣转链接口,否则转链后依然是低佣金,如需快速代做升级请联系客服。

特别注意: qh_final_price 券后价 可能是负数,当优惠券是满减券(购买多件商品才可以使用)的时候,需要特别判断一下。

接口地址: http://api.tbk.dingdanxia.com/tbk/id_privilege 在线测试

非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

id

String

商品id

pid

String

淘宝联盟推广位pid,必须为在本平台授权淘宝账号下的pid,否则无效。如不传该参数则默认走后台填写的pid

relation_id

String

渠道关系 ID,即备案到该合作方下面的唯一的渠道关系 ID,通过此关系 ID 进行转链即可实现订单的数据追踪,查看渠道订单数据; 注意:转链时候所传pid参数必须是您“渠道专属推广位”内的专属pid才可以,否则订单接口中无法返回渠道id信息。

special_id

String

会员运营ID

external_id

String

淘宝客外部用户标记,如自身系统账户ID;微信ID等

tpwd

Boolean

true

是否生成淘口令,true 或false, 默认不生成,可生成优惠券口令和商品链接口令

activityId

String

阿里妈妈推广券ID,如果传该参数,则高佣链接将展现此券信息,不传会自动查找其它券。

logo

String

https://img.alicdn.com/tps/i4/TB18f82hBv0gK0jSZKbSuvK2FXa.jpg_400x400q90.jpg

要生成口令的图片, 默认使用商品主图

text

String

领券下单更优惠

要生成口令的标题,默认使用商品标题

itemInfo

Boolean

true

true或false,是否返回商品信息,包含标题、一口价、折扣价、券后价、券后佣金,是否天猫, 默认false

extspk

Boolean

true

true或false,是否同时去查私有券、猫超券,默认false不开启,开启后可能稍微增加转链响应速度,请合理使用。

left_symbol

String

¥

淘口令左边符号,默认¥

right_symbol

String

¥

淘口令右边符号,默认¥

shorturl

Boolean

true

coupon_click_url 和 item_url 是否生成短连接

返回参数说明

标记

类型

例子

说明

category_id

Number

123

后台一级类目

coupon_click_url

String

https://uland.taobao.com/coupon/edetail?e=xxxxx

商品优惠券推广链接

coupon_start_time

String

2019-01-26

优惠券起始时间

coupon_end_time

String

2019-09-26

优惠券结束时间

coupon_info

String

满16元减10元

优惠券面额说明

coupon

String

10

优惠券面额

item_id

Number

123456789

商品id

max_commission_rate

String

20.3

佣金比率(%)

coupon_total_count

Number

300

优惠券总量

coupon_remain_count

Number

123

优惠券剩余量

mm_coupon_remain_count

Number

321

妈妈优惠券剩余量

mm_coupon_total_count

Number

400

妈妈优惠券总量

mm_coupon_click_url

String

https://uland.taobao.com/coupon/edetail?e=nqUNB

商品妈妈优惠券推广链接

mm_coupon_start_time

String

2019-01-13

妈妈优惠券开始时间

mm_coupon_end_time

String

2019-10-13

妈妈优惠券结束时间

mm_coupon_info

String

满20元减15元

妈妈优惠券面额

coupon_type

Number

1

优惠券(商品优惠券推广链接中的券)类型,1 公开券,2 私有券,3 妈妈券

item_url

String

https://s.click.taobao.com/t?.....

商品淘客链接

coupon_tpwd

String

¥LGF9bKz5nJt¥

二合一领券链接口令

item_tpwd

String

¥LGF9bKz5nJt¥

商品推广链接口令

itemInfo

String[]

商品返利信息

title

String

短裤

商品标题

pict_url

String

https:\/\/img.alicdn.com\/bao\/uploaded\/i3\/880734502\/O1CN0173hsRV1j7xbXmtG3c_!!0-item_pic.jpg

商品主图

reserve_price

String

360

一口价

zk_final_price

String

188

折扣价

qh_final_price

String

168

券后价

qh_final_commission

String

32

券后佣金

activityId

String

sasasasa

券ID

user_type

Number

1

卖家类型,0表示集市,1表示天猫商城

volume

Number

1234

销量(该销量有一定缓存时间, 不一定与淘宝一致)

ysyl_click_url

String

https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG

预售有礼-推广链接

ysyl_tlj_face

String

0.6

预售有礼-预估淘礼金(元)

ysyl_tlj_send_time

String

2019-11-10 21:59:59

预售有礼-淘礼金发放时间

ysyl_commission_rate

String

20.3

预售有礼-佣金比例(%)

ysyl_tlj_use_start_time

String

2019/11/11 01:00:00

预售有礼-淘礼金使用开始时间

ysyl_tlj_use_end_time

String

2019/11/11 23:59:59

预售有礼-淘礼金使用结束时间

min_commission_rate

String

20.3

当入参special_id、relation_id、external_id时,该字段展示预估最低佣金率(%)

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "category_id":16,
        "coupon_click_url":"https://uland.taobao.com/coupon/edetail?e=Ds%2BPHbgdwkUGQASttHIRqSl4S0c8Z1kpxIdSNWbQHrQOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllArPZdVDM9ZWx5Bh%2BsFgnewCUgftRHNY33ct%2FzOJQMDvl6zroKjs8vldxfFlZSCevABMuaLTxEb8p6OLkzCnx2Iw%2FuvuI92sOE3lUKf0oId1qsrTYMHtNBEO2%2BHjDKsarTM%3D&traceId=0b1da62d15943909083553929e&relationId=2527782251&union_lens=lensId:TAPI@1594390908@0b0fe08b_0e19_173391a8dde_dad9@01&xId=25ahEELfwXLGTSalqdVRo3VykNgQx809qHFBvu5lODygYmOiIL1fod0WcU5f8X5eKXYmzYk0KfU3gEnrceJNl2JIdxAa3Yvm8m2GkYYbaNXu",
        "coupon_end_time":"2020-07-16",
        "coupon_info":"满55元减50元",
        "coupon_remain_count":100000,
        "coupon_start_time":"2020-07-10",
        "coupon_total_count":100000,
        "coupon_type":3,
        "item_id":578766218859,
        "item_url":"https://s.click.taobao.com/t?e=m%3D2%26s%3DtWpUsvnC8uNw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLLWlSKdGSYDkOVa0KUtGz0MMgx22UI05Yxnzm7RurvT%2FIyEWtIUaUGG8VZNgwgNp7USp33hvN5HvbYLxMxKWJQ4hXp5zt9EMqi1jMNxDhLMhrRwxA9orHdCVmlxjk6VEPrkts%2F%2FKJvBgNdzcFFug%2Bbasj7t7DpxvlPUBfw1njANUo7k61Yjavelhdx4e4%2FwumS6I9hgd%2FEUOHVK%2FKzLDVFKuP01heb7XyiZ%2BQMlGz6FQ%3D%3D&union_lens=lensId:TAPI@1594390908@0b0fe08b_0e19_173391a8dde_dad9@01&xId=25ahEELfwXLGTSalqdVRo3VykNgQx809qHFBvu5lODygYmOiIL1fod0WcU5f8X5eKXYmzYk0KfU3gEnrceJNl2JIdxAa3Yvm8m2GkYYbaNXu",
        "max_commission_rate":"6.15",
        "min_commission_rate":"6.15",
        "coupon":"50",
        "itemInfo":{
            "title":"中年女装妈妈装夏装运动套装女短袖夏季休闲服中老年两件套装女夏",
            "pict_url":"https://img.alicdn.com/bao/uploaded/i3/429157528/O1CN01g2utRg25TsAjd7hUk_!!429157528.jpg",
            "reserve_price":228,
            "zk_final_price":118,
            "qh_final_price":68,
            "qh_final_commission":4.18,
            "user_type":0,
            "volume":104,
            "nick":"卓陆服饰精品"
        },
        "coupon_tpwd":"¥PlU11yal3EJ¥",
        "item_tpwd":"¥qXgt1yaPGsx¥"
    }
}
			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。