淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
企业微信

数据接口API

点击获取APKEY

正常 (重构版)淘客官方活动推广(更新版)

更新时间:2020-09-03 12:39:51

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

使用说明

此接口目前只支持饿了么、口碑生活周等相关活动转链,有需要的可以接入,其他活动目前依然还是需要使用原官方活动转链接口。

口碑城市生活周:https://pages.tmall.com/wow/alsc/mod/c9e5472d65868f931d350439

活动ID:1583739244161

饿了么聚合页,每天领红包,活动ID:1571715733668

生活服务分会场活动ID:1583739244162

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
tbnameStringxxxx在本平台授权的淘宝用户名,有中文时需进行Urlencode编码
pidStringmm_123456_456789_789132淘宝联盟PID
activity_material_idStringxxxx活动ID,支持通过推广位和活动物料id获取活动详情,包含推广url(长链、短链),淘口令、微信推广二维码地址等。淘宝联盟官方活动推广API-工具,支持二方、三方
relation_idStringxxxx渠道关系id
hastpwdString1是否生成淘口令,1为生成,不填或填写其他为不生成,如果生成,则tpwd_title参数必须传入,否则不生效
tpwd_titleString淘口令标题与hastpwd配合使用
union_idStringVxxxxxxx自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据列表
 ├ click_urlString活动推广地址
 ├ tpwdString活动推广地址对应的淘口令此为可选项,详见入参说明
 ├ wx_qrcode_urlString微信小程序推广二维码地址【本地化】微信推广二维码地址
 ├ short_click_urlString推广短链
 ├ terminal_typeString投放平台, 1-PC 2-无线
 ├ material_oss_urlString物料素材下载地址
 ├ page_nameString会场名称
 ├ page_start_timeString活动开始时间
 ├ page_end_timeString活动结束时间活动结束时间
 ├ wx_miniprogram_pathString【本地化】微信小程序推广路径

Json返回示例

{"code":200,"data":{"click_url":"https://s.click.koubei.com/t?&e=-s02yxxxxx01","tpwd":"¥75xxxx0Q¥"},"msg":"success"}

code/http_status说明

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