淘口令接口相关的共用三个:
淘口令接口1(tbtkl):用于生成淘客推广的链接,比如s.click和uland二合一推广链接,以及授权链接等。
淘口令接口2(tbtklreport):用于生成您的淘宝客推广淘口令成交数据。支持淘宝客获取单个淘口令的回流PV、UV数据。
淘口令接口3(powertkl):万能淘口令,可以生成接口1以外的淘系链接,比如淘宝产品详情页URL生成淘口令。
接口使用说明:
适用于生成淘客推广链接,比如uland.taobao.com,s.click.taobao.com推广链接生成淘口令,以及渠道备案中使用参数rtag进行备案的网址(mos.m.taobao.com)生成淘口令。
【调用权限】核心会员卡可免费调用。
【适用范围】适用于生成淘客推广链接,包括:
1、淘宝客产品推广链接s.click和uland.taobao.com二合一链接等等。
2、淘宝店铺推广链接s.click生成淘口令
3、渠道手工备案链接https://mos.m.taobao.com/inviter/register..生成淘口令(参http://wsd.591hufu.com/taokelianmeng/411.html)
【接口地址】接口地址tbtkl,完整如下:
http://api.veapi.cn/tbk/tbtkl?vekey=xxx&text=....&pic=...&url=...
参数:
vekey 必选:注册会员后,购买会员卡后授权完取得vekey
text 必选:淘口令文本,5个字以上
url 必选:淘客推广链接(参上文“适用范围”)。请对网址做 urlencode 编码后传参数给url。
pic 可选:淘口令弹窗的图片。由于2019年双11前联盟取消所有非自身生成的淘口令弹窗图的显示,因此这个参数失去了意义,因此可不需要提供本参数。后期如恢复弹窗图片显示,可指定本参数为你自己的图片地址。
【返回值】
如下:
{
"error": "0",
"msg": "淘口令生成成功",
"data": {
"tbk_pwd": "¥9O9IctHMHsR¥", //安卓手机淘口令
"ios_tbk_pwd": "6¥9O9IctHMHsR¥达開...", //IOS14以上的系统使用的淘口令
"global_tbk_pwd": "6¥9O9IctHMHsR¥/" //安卓和IOS14通用的淘口令
}
}
适用于您检查发出的淘口令推广效果,支持获取淘宝客获取单个淘口令的回流PV、UV数据。
【调用权限】核心会员卡可免费调用。
【接口地址】接口地址tbtkl,完整如下:
http://api.veapi.cn/tbk/tbk/tbtklreport?vekey=xxx&pid=mm_xxx&tao_password=0¥EcbCXlYc9yJ¥/
参数:
vekey 必选:注册会员后,购买会员卡后授权完取得vekey
pid 必选:你的淘口令中的PID
tao_password 必选:要获取回流数据的淘口令,可以是淘口令,也可以包含淘口令的短文本,比如
8.0¥RgyOXlb162v¥ https://m.tb.cn/h.1AgQ6QK 白色t恤短袖紧身纯棉上衣
【返回值】
淘口令回流数据接口返回值含义如下:
{
"error": "0",
"msg": "淘口令回流数据查询成功!",
"data": {
"hour_pv": 1320, //截止查询时刻近1小时回流pv
"hour_uv": 1230, //截止查询时刻近1小时回流uv
"pv": 6520, //今日截止查询时刻累计pv
"uv": 9520 //今日截止查询时刻累计uv
}
}
适合于任意的淘宝系的网址生成淘口令,比如授权备案链接https://oauth.taobao.com/authorize ,或其它阿里系的网址(淘宝、天猫、1688、优酷、饿了么、阿里云等等网址。比如淘宝产品详情页链接)均可生成淘口令。
本接口还可以生成淘宝短链接。
支持淘系链接生成淘口令。比如渠道备案授权网址https://oauth.taobao.com/authorize生成淘口令。或淘宝天猫产品页链接、或1688、优酷、饿了么、阿里云等等网址。
本接口还可以生成淘宝短链接tb.cn,方便推广。
如果你只需在线生成,参考在线万能淘口令工具:
【调用权限】需要专用的“万能淘口令点卡”按次计费,失败不计费。
【适用范围】只要是阿里系的网址均可生成淘口令,比如淘宝、天猫、优酷、飞猪、阿里云...等等的网址。
严禁用于淘口令粉用途,否则将冻结帐号。
【接口】
http://api.veapi.cn/tbk/powertkl?vekey=xxx&text=任意淘系链接转淘口令&pic=...&url=...
【参数】
text 必选:淘口令文本,5个字以上。
pic 必选:淘口令图片
url 必选:淘系链接。请务必对网址做 urlencode 编码 后再传给url。
biz_id 可选(一般不需要本参数):特定场景参数,一般不需要传本参数,但有时你的链接生成的淘口令在手淘APP上可能“不弹窗”,那么可以尝试本参数。可以指定biz_id=1 或具体指定场景值,如biz_id=lianmeng-app(需要你明确知道链接的场景参数,不是随便乱写的,如果不知道淘口令不弹窗且您不知道biz_id要传什么值时,可联系本站)。
特别强调:
1.仅当发现你的url生成的淘口令在手淘APP上不能弹窗时,才尝试biz_id参数。
2.活动类等特定链接,才用的上biz_id参数
示例:http://api.veapi.cn/tbk/powertkl?vekey=xxx&text=快来参加活动&pic=...&url=...&biz_id=1
biz_id用途:
当您生成的是特定场景的链接,如果生成的淘口令不能弹窗,请尝试这个biz_id参数。
一般这类链接需要提供场景参数,否则生成的淘口令可能在淘宝中不会弹窗!
比如 “聚划算品牌清仓”:
这个链接 https://s.click.taobao.com/RtpWTpv 本身没有问题,但因为是特写场景的链接,如果不提供biz_id参数,生成的淘口令打开手淘APP不会弹窗。
【特别注意】
传参数url时,注意url中不要带有“空格,引号”等,否则可能会导致口令在手淘APP可以弹出,但不会跳转,或淘口令无反应现象,一旦你发现这种现象时,请检查url参数。如图中的url尾部多了一个引号,导致后面参数属性在淘宝中无法识别,因此不会跳转到这个网址:
【返回值】
包括淘口令,淘宝m.tb.cn短链,如下:
{
"error": 0,
"msg": "操作成功",
"data": {
"password": "¥ACszbMSXOcf¥",
"createTime": "1545142942632",
"validDate": "1547734942626",
"longUrl": "https://www.tmall.com/?ut_sk=1.utdid_215....",
"content": "【任意淘系网址转淘口令】https://m.tb.cn/h.3pq7D80 点击链接,再选择浏览器咑閞;或復·制这段描述¥ACszbMSXOcf¥后咑閞👉淘♂寳♀👈",
"url": "https://m.tb.cn/h.3pq7D80"
}
}
出错时返回:
{
"error": 400,
"msg": "PARAMETER_ERROR_URL_ILLEGAL::URL domain illegal",
"data": []
}
请按需调用以上2种淘口令接口。