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

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

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

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

id

String

Q0v7268hQtkzM0vIWb3tatQ-BmwQygirK7xkKx8H0

商品id

pid

String

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

relation_id

String

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

special_id

String

会员运营ID

external_id

String

淘宝客外部用户标记,如自身系统账户ID;微信ID等 详细说明:https://www.yuque.com/kuaifan/vcftkp/lr37p9

get_topn_rate

Number

0

是否获取前N件佣金 ,0-否,1-是,其他值-否

tpwd

Boolean

true

是否生成淘口令,true 或false, 默认不生成,可生成优惠券口令和商品链接口令 其他注意事项:https://www.dingdanxia.com/article/127.html

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 是否生成短连接

xid

String

adsads

团长与下游渠道合作的特殊标识,用于统计渠道推广效果

appkey

String

自己淘宝开放平台具有口令生成权限的appkey 详细说明 https://www.dingdanxia.com/article/127.html

appsecret

String

自己淘宝开放平台具有口令生成权限的appsecret 详细说明 https://www.dingdanxia.com/article/127.html

tb_auth_id

Number

多个联盟号授权切换某一个时使用

access_token

String

多用户授权参数

返回参数说明

标记

类型

例子

说明

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

优惠券剩余量

coupon_type

Number

1

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

item_url

String

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

商品淘客链接

coupon_tpwd

String

¥pAVecW4RhmT¥

二合一领券链接口令

long_coupon_tpwd

String

4fu至内容¥pAVecW4RhmT¥到τa0寳或点几炼接 https://m.tb.cn/h.VDoOC0m 至浏.览览.器【2020秋冬款女改良旗袍民族风女装棉麻长款盘扣袍子中式复古连衣裙】

二合一领券链接长口令 兼容ios14

item_tpwd

String

¥ZKFKcW4izrj¥

商品推广链接口令

long_item_tpwd

String

3.0覆置内容¥ZKFKcW4izrj¥da開τao寶或掂击链街 https://m.tb.cn/h.Vx5sYS1 至流览器【2020秋冬款女改良旗袍民族风女装棉麻长款盘扣袍子中式复古连衣裙】

商品推广链接长口令 兼容 ios 14

itemInfo

String[]

商品返利信息

L title

String

短裤

商品标题

L pict_url

String

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

商品主图

L small_images

String[]

商品轮播图

L reserve_price

String

360

一口价

L zk_final_price

String

188

折扣价

L qh_final_price

String

168

券后价

L qh_final_commission

String

32

券后佣金

L user_type

Number

1

卖家类型,0表示集市,1表示商城,3表示特价版

L volume

Number

1234

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

L seller_id

Number

123

卖家id

L nick

String

xx旗舰店

店铺名称

L material_lib_type

String

1

商品库类型,支持多库类型输出,以英文逗号分隔“,”分隔,1:营销商品主推库,如果值为空则不属于1这种商品类型

activityId

String

sasasasa

券ID

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时,该字段展示预估最低佣金率(%)

reward_info

Number

1

比价场景专用,当系统检测到入参消费者ID购买当前商品会获得《天天开彩蛋》玩法的彩蛋时,该字段显示1,否则为0

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"category_id": 16,
		"coupon_click_url": "https://uland.taobao.com/coupon/edetail?e=5nRSRGAgqbUGQASttHIRqXizBmlOJRBzO6fdOnYz2c4OA9IyHvt%2BInHddMIpLB%2FnLd6Qy%2B%2F7I6h834pmFuJ%2FJ202%2F1k20DLu%2BGoSNEAjokQ4M2%2FUXT47GBemP0hpIIPvjDppvlX%2Bob8NlNJBuapvQ2MDg9t1zp0RW22rjtZ8rUqCgVMQ7vG1lEMuxoRQ3C%2BHLTrfX8AoEDSie%2FpBy9wBFg%3D%3D&traceId=0b0fa53615989317749782367e&union_lens=lensId:TAPI@1598931775@0b1833f0_0d60_17447c2ae31_6755@01",
		"coupon_end_time": "2020-09-01",
		"coupon_info": "满80元减50元",
		"coupon_remain_count": 680,
		"coupon_start_time": "2020-08-26",
		"coupon_total_count": 1000,
		"item_id": 575588057285,
		"item_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DAKwav83fYTpw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLLWlSKdGSYDr4z91%2B%2FAafa5x%2BIUlGKNpUxnzm7RurvT%2FIyEWtIUaUGiIFvtM1reihvcVuZ%2FfxVm4z4rjZDGVMAg9EM63abczk%2BxTkjxeW0O6Q6sZp7gNLm5rVRUC83csZQmr2f4L%2FGPP7nyHmkoZi71hjz2dNwkcT433nK3xxqwmmsWF8%2BPwdLfX2p8ipvVWUvfeUUl6%2F7pA%3D%3D&union_lens=lensId:TAPI@1598931775@0b1833f0_0d60_17447c2ae31_6755@01",
		"max_commission_rate": "2.40",
		"coupon": "50",
		"itemInfo": {
			"title": "2020秋冬款女改良旗袍民族风女装棉麻长款盘扣袍子中式复古连衣裙",
			"pict_url": "https://img.alicdn.com/bao/uploaded/i2/143749361/O1CN01lDfqY42J1OBpZ1SVe_!!0-item_pic.jpg",
			"small_images": {
				"string": [
					"https://img.alicdn.com/i1/143749361/O1CN01tvKpz02J1O84GRHUx_!!143749361.jpg",
					"https://img.alicdn.com/i4/143749361/O1CN01zkmyOk2J1O83XwixJ_!!143749361.jpg",
					"https://img.alicdn.com/i2/143749361/O1CN015z76ff2J1O878pI4t_!!143749361.jpg",
					"https://img.alicdn.com/i3/143749361/O1CN017VFNk82J1O5PR1IMt_!!143749361.jpg"
				]
			},
			"reserve_price": 268,
			"zk_final_price": 139,
			"qh_final_price": 89,
			"qh_final_commission": 2.14,
			"user_type": 0,
			"volume": 80,
			"seller_id": 143749361,
			"nick": "布衣美人原创",
			"material_lib_type": "1"
		},
		"coupon_tpwd": "¥rrg7cW4O07u¥",
		"long_coupon_tpwd": "7fu至本段内容¥rrg7cW4O07u¥咑幵ta0寶或点几炼接 https://m.tb.cn/h.Vx5xV2J 至流览器【2020秋冬款女改良旗袍民族风女装棉麻长款盘扣袍子中式复古连衣裙】",
		"item_tpwd": "¥dtnTcW4lw5e¥",
		"long_item_tpwd": "0.0fu置内容¥dtnTcW4lw5e¥转移至淘tao寳或掂击链街 https://m.tb.cn/h.Vx5EXkh 至瀏lan嘂..【2020秋冬款女改良旗袍民族风女装棉麻长款盘扣袍子中式复古连衣裙】"
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。