淘宝客API
开放平台API
企业微信

数据接口API

点击获取APKEY

正常 (重构版)淘宝联盟官方活动推广API


请求链接: http://api.web.21ds.cn/taoke/getTbkActivityLink
请求实例: http://api.web.21ds.cn/taoke/getTbkActivityLink?apkey=登录后即可显示&pid=mm_123456_456789_789132&tbname=xxxxx&activity_id=12345678 (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
今日调用统计: 暂无统计
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 淘宝联盟官方活动推广API
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-
限时推广:送你100元借款优惠券!借款时可用。(数量有限,先到先得) ->>立即领取<<-

使用说明

传入参数取消推广位ID及站点ID,改为传入PID,由系统进行处理

原接口返回数据格式:

{"code":200,"data":"https://s.click.taobao.com/t?e=m%3D2%26s%3Dpxxxxxxxyh8YMXU3NNCg%2F&pvid=25013252","msg":"活动链接获取成功"}

重构版返回数据格式:

{"code":200,"data":{"url":"https://s.click.taobao.com/t?e=m%3D2%26s%3xxxxfa_6803","tpwd":"¥R1NxxxxJUh¥"},"msg":"success"}

变更说明:

将data字段调整为数组格式,将淘客链接及口令合并在data中

活动ID获取方式如下:

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
pidStringmm_123456_456789_789132pid
tbnameStringxxxxx在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页
activity_idNumber12345678官方活动ID,从官方活动页获取
union_idString自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道
relation_idNumber渠道关系ID,仅适用于渠道推广场景
platformNumber11:PC,2:无线,默认:1
hastpwdNumber1是否生成淘口令,1为生成,不填或填写其他为不生成,如果生成,则tpwd_title参数必须传入,否则不生效
tpwd_titleString淘口令标题与hastpwd配合使用
tpwd_logoString淘口令弹窗图

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据
 ├ urlString淘宝联盟官方活动推广URL淘客链接
 ├ tpwdString淘口令不生成时为空

Json返回示例

{"code":200,"data":{"url":"https://s.click.taobao.com/t?e=m=2&s=xCqxxxxxxns=lensId:0b582d96_0c1d_16e783f57fa_6803","tpwd":"¥R1N9xxxxJUh¥"},"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对