淘口令高佣转链api|淘口令转成自己的链接|淘宝客高佣转链api接口|查券接口|商品id转链接口|单品券高效转链API|taobao.tbk.privilege.get|订单侠开放平台

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

参数接口

参数类型

必填

示例

说明

apikey

string

是

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

tkl

String

是

淘口令，支持传入包含口令的整个文案，但最好是直接传一个口令

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

String

否

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

activityId

String

否

阿里妈妈推广券ID，如果传该参数，则高佣链接将展现此券信息

logo

String

否

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

text

String

否

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

itemInfo

Boolean

否

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

extspk

Boolean

否

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

left_symbol

String

否

¥

淘口令左边符号，默认￥

right_symbol

String

否

¥

淘口令右边符号，默认￥

shorturl

Boolean

否

true

coupon_click_url 和 item_url 是否生成短连接

xid

String

否

asasa

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

appkey

String

否

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

appsecret

String

否

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

tb_auth_id

Number

否

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

标记

类型

例子

说明

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

12345

销量（该销量有一定缓存时间，不一定与淘宝一致）

L seller_id

Number

123

卖家id

L nick

String

xx旗舰店

店铺名称

L material_lib_type

String

1

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

activityId

String

asasasass

券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

请求拒绝

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

首页

关于

联系我们