淘宝联盟API
京东联盟API
拼多多API
唯品会API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
点击获取APKEY

正常 淘客官方活动推广 接口测试

淘宝客官方活动转链(更新版)

接口地址: http://api.web.ecapi.cn/taoke/getTbkActivityInfo
接口实例: http://api.web.ecapi.cn/taoke/getTbkActivityInfo?apkey=登录会员中心查看&tbname=xxxx&pid=mm_123456_456789_789132&activity_material_id=xxxx&relation_id=xxxx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

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

活动ID:1583739244161

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
tbnameStringxxxx在本平台授权的淘宝用户名,有中文时需进行Urlencode编码
pidStringmm_123456_456789_789132淘宝联盟PID
activity_material_idStringxxxx活动ID,支持通过推广位和活动物料id获取活动详情,包含推广url(长链、短链),淘口令、微信推广二维码地址等。淘宝联盟官方活动推广API-工具,支持二方、三方
relation_idStringxxxx渠道关系id,获取说明:https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639
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请求方式不对