淘宝客-推广者-商品链接转换
淘宝客-公用-淘宝客商品详情查询(简版)
淘宝客-推广者-商品三方分成链接转换
淘宝客-推广者-店铺搜索
淘宝客-公用-店铺关联推荐
淘宝客-推广者-店铺链接转换
淘宝客-推广者-店铺三方分成链接转换
淘宝客-公用-长链转短链
淘宝客-推广者-根据宝贝id批量查询优惠券
淘宝客-公用-链接解析出商品id
淘宝客-服务商-保护门槛
淘宝客-服务商-单品券高效转链
淘宝客-推广者-单品券高效转链
淘宝客-公用-阿里妈妈推广券详情查询
淘宝客-公用-淘口令生成
淘宝客-推广者-创建推广位
淘宝客-公用-文本淘口令
淘宝客-推广者-淘口令解析&三方分成转链
淘宝客-推广者-淘口令解析&转链
淘宝客-推广者-新用户订单明细查询
淘宝客-服务商-新用户订单明细查询
淘宝客-推广者-物料精选
淘宝客-服务商-创建推广者位
淘宝客-服务商-物料搜索
淘宝客-推广者-物料搜索
淘宝客-推广者-拉新活动对应数据查询
淘宝客-服务商-拉新活动数据查询
淘宝客-服务商-物料精选
淘宝客-公用-私域用户备案
淘宝客-公用-私域用户备案信息查询
淘宝客-公用-私域用户邀请码生成
淘宝客-公用-pid校验
淘宝客-推广者-售后退款订单查询
淘宝客-推广者-淘礼金创建
报表查询
淘宝客-服务商-处罚订单查询
淘宝客-推广者-处罚订单查询
淘宝客-公用-淘口令解析出原链接
淘宝客-推广者-图文智能识别消费者端推荐物料查询
淘宝客-推广者-图文智能识别达人端物料上传
淘宝客-推广者-所有订单查询
淘宝客-服务商-所有订单查询
淘宝客-服务商-淘口令解析&转链
淘宝客-服务商-售后退款订单查询
淘宝客-服务商-店铺链接转换
淘宝客-推广者-媒体数据报表交换
淘宝客-推广者-官办找福利页
淘宝客-推广者-物料上行
淘宝客-推广者-媒体数据报表交换-汇总数据
淘宝客-推广者-媒体数据交换报表点击维度
淘宝客-公用-淘宝客商品详情查询(详细版)
淘宝客-推广者-快手日报(达人维度)
淘宝客-推广者-达人实时销量汇总数据
淘宝客-推广者-快手月报(达人维度)
内容媒体-达人实时销量榜单
淘宝客-服务商-查询红包发放个数
淘宝客-推广者-查询红包发放个数
淘宝客商品展示规则获取
淘宝客-推广者-微博日报(达人维度)
淘宝客-推广者-微博月报(达人维度)
淘宝客-推广者-官方活动转链
淘宝客-服务商-官方活动转链
淘宝客-推广者-媒体智能化投放
淘宝客-招商团长-服务费订单明细
淘宝客-工具-团长-所有订单查询
淘宝客-服务商-渠道管理rid推广效果
淘宝客-推广者-权益物料精选
淘宝客-服务商-权益物料精选
淘宝客-服务商-红包领取状态查询
淘宝客-推广者-红包领取状态查询
淘宝客-推广者-拍立淘插件转链
淘宝客-服务商-创建人群标签
淘宝客-服务商-私域会员标记
淘宝客-服务商-上传人群数据
淘宝客-服务商-拍立淘插件转链
淘宝客-服务商-商业化图片生成
购物车催付优惠券到期查询用户信息
淘宝客-服务商-人群推广效果
sku维度最优优惠券信息
淘宝客-推广者-互动任务投放
淘宝联盟厂商找优惠
淘宝客-服务商-定向活动目标发布
淘宝客-推广者-定向活动目标发布
淘宝客-推广者-CPA活动执行明细
淘宝客-推广者-淘口令回流数据查询
淘宝客-服务商-淘口令回流数据查询
淘宝客-服务商-CPA活动执行明细
淘宝客-推广者-加密淘口令生成
淘宝客-服务商-加密淘口令生成
淘宝客-推广者-任务奖励效果报表
淘宝客-服务商-任务奖励效果报表
淘宝客-推广者-淘礼金暂停发放
淘宝客-推广者-淘礼金效果数据
淘宝客-推广者-淘口令预警及拦截查询
淘宝客-服务商-淘口令预警及拦截查询
淘宝客-推广者-淘礼金三方链接转换
淘宝客-服务商-单品推荐
淘宝客-推广者-种草指标报表
淘宝客-服务商-物料精选升级版
淘宝客-推广者-物料精选升级版
淘宝客-推广者-内容种草人群包数据查询
淘宝客-推广者-内容ID订单汇总
淘宝客-服务商-member组查询&新增
淘宝客-推广者-商品id升级(三方)
淘宝客-推广者-商品id转化(二方)(专有)
淘宝客-推广者-物料id列表查询
淘宝客-服务商-爆料分享物料获取
淘宝客-推广者-爆料分享物料获取
淘宝客-公用-爆料分享物料上传
淘宝客-推广者-内容种草任务列表下行
淘宝客-推广者-种草内容数据写入
淘宝客-推广者-导购数据上传
淘宝客-公用-淘宝客商品详情查询升级版(详细版)
淘宝客-服务商-物料搜索升级版
淘宝客-推广者-物料搜索升级版
淘宝客-公用-淘宝客商品详情查询升级版(简易版)
淘宝客-推广者-全量售后退款订单查询
淘宝客-公用-失效商品id转化
淘宝客-服务商-全量售后退款订单查询
淘宝客-推广者-万能转链
淘宝客-服务商-万能转链
淘宝客-推广者-内容种草投流明细数据上传
淘宝客-推广者-多品凑单上传
淘宝客-推广者-内容投流关系写入
淘宝客-推广者-内容种草投流前链路数据上传
淘宝客-推广者-内容种草投流数据交换
淘宝客-推广者-投流任务信息下行
淘宝客-推广者-加密用户标识生成
淘宝客-推广者-种草商单子任务改价申请
淘宝客-推广者-种草商单子任务改价结果查询
淘宝客-推广者-厂商版加密用户标识获取
淘宝客-推广者-内容种草投流对账单
商业化消息推送
淘宝客-推广者-厂商版-个性化推荐商品获取
淘宝客-推广者-内容三方万能转链
通用用户监测数据上传
淘宝客-服务商-群信息获取
淘宝客-服务商-社群创建
淘宝客-服务商-社群删除
淘宝客-服务商-群内人群管理
淘宝客-服务商-加密用户标识生成
获取服务商达人数据
淘宝客_推广者_个性化商品获取
淘宝客_服务商_个性化商品获取
淘宝客-服务商-商品行为上报
淘宝客-推广者-商品行为上报
淘宝客-推广者-万能解析
淘宝客-服务商-万能解析
淘宝-淘宝客-服务商-用户绑定状态查询
淘宝-淘宝客-推广者-用户绑定状态查询
商单种草任务内容信息变更
淘宝客-服务商-自定义服务组成员修改
淘宝客-服务商-自定义服务组成员查询
淘宝客-推广者-UVID人群挑量
淘宝客-服务商-UVID人群挑量
淘宝客-内容三方-媒体数据报表交换-汇总数据
创建社群拉新礼金
淘宝客-服务商-订单ID挑量
淘宝客-推广者-目标用户批量匹配
淘宝客-服务商-拉新CPA奖励明细数据
生态发单计划拉取
生态发单结果回调
生态发单通路状态上报
淘宝客-服务商-联盟推广位查询API
淘宝客-服务商-物料上翻
淘宝客-服务商-物料更新
环境 | HTTP请求地址 | HTTPS请求地址 |
---|---|---|
正式环境 | http://gw.api.taobao.com/router/rest | https://eco.taobao.com/router/rest |
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
method | String | 是 | API接口名称。 |
app_key | String | 是 | TOP分配给应用的AppKey。 |
target_app_key | String | 否 | 被调用的目标AppKey,仅当被调用的API为第三方ISV提供时有效。 |
sign_method | String | 是 | 签名的摘要算法,可选值为:hmac,md5。 |
sign | String | 是 | API输入参数签名结果,签名算法介绍请点击这里。 |
session | String | 否 | 用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请点击这里。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选。 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。 |
format | String | 否 | 响应格式。默认为xml格式,可选值:xml,json。 |
v | String | 是 | API协议版本,可选值:2.0。 |
partner_id | String | 否 | 合作伙伴身份标识。 |
simplify | Boolean | 否 | 是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false。 |
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
cont_id | String | 必须 | 123 | 内容ID | |
cont_url | String | 必须 | taobao.s.click.com_cont_id | 内容URL | |
create_time | String | 可选 | 2015-01-01 12:00:00 | 内容ID创建时间,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8 | |
packet_sign | Number | 必须 | 1 | 超级红包标识,“1”为超红内容,“0”为非超红内容 | |
weight_sign | Number | 可选 | 1 | 内容加权标识,“1”为媒体对内容做了特殊加权,“0”为媒体没有特殊处理 | |
daren_nickname | String | 必须 | abc | 达人昵称 | |
daren_pid | String | 必须 | mm_12345_0_0 | 达人联盟Pid | |
read_number | Number | 必须 | 123 | 阅读量 | |
interact_number | Number | 必须 | 123 | 互动量(点赞or收藏or评论) | |
item_list | String | 必须 | 123,45 | 回传全量的商品id,历史上存在过的(包括删除的)商品id均需上传。 eg:1号上传abcde商品,当天b c d 商品删除了,新增了f g 那2号上传的就是abcdefg | |
extra | String | 可选 | 123 | 扩展参数 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
results | Json | 结果列表 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); TbkMediaDataUploadRequest req = new TbkMediaDataUploadRequest(); req.setContId( "123" ); req.setContUrl( "taobao.s.click.com_cont_id" ); req.setCreateTime( "2015-01-01 12:00:00" ); req.setPacketSign(1L); req.setWeightSign(1L); req.setDarenNickname( "abc" ); req.setDarenPid( "mm_12345_0_0" ); req.setReadNumber(123L); req.setInteractNumber(123L); req.setItemList( "123,45" ); req.setExtra( "123" ); TbkMediaDataUploadResponse rsp = client.execute(req); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | ITopClient client = new DefaultTopClient(url, appkey, secret); TbkMediaDataUploadRequest req = new TbkMediaDataUploadRequest(); req.ContId = "123" ; req.ContUrl = "taobao.s.click.com_cont_id" ; req.CreateTime = "2015-01-01 12:00:00" ; req.PacketSign = 1L; req.WeightSign = 1L; req.DarenNickname = "abc" ; req.DarenPid = "mm_12345_0_0" ; req.ReadNumber = 123L; req.InteractNumber = 123L; req.ItemList = "123,45" ; req.Extra = "123" ; TbkMediaDataUploadResponse rsp = client.Execute(req); Console.WriteLine(rsp.Body); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | $c = new TopClient; $c ->appkey = $appkey ; $c ->secretKey = $secret ; $req = new TbkMediaDataUploadRequest; $req ->setContId( "123" ); $req ->setContUrl( "taobao.s.click.com_cont_id" ); $req ->setCreateTime( "2015-01-01 12:00:00" ); $req ->setPacketSign( "1" ); $req ->setWeightSign( "1" ); $req ->setDarenNickname( "abc" ); $req ->setDarenPid( "mm_12345_0_0" ); $req ->setReadNumber( "123" ); $req ->setInteractNumber( "123" ); $req ->setItemList( "123,45" ); $req ->setExtra( "123" ); $resp = $c ->execute( $req ); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | -H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \ -d 'app_key=12129701' \ -d 'format=json' \ -d 'method=taobao.tbk.media.data.upload' \ -d 'partner_id=apidoc' \ -d 'sign=250EF83E35B0078D5F0069CAF75DEB4A' \ -d 'sign_method=hmac' \ -d 'timestamp=2025-07-05+21%3A52%3A18' \ -d 'v=2.0' \ -d 'cont_id=123' \ -d 'cont_url=taobao.s.click.com_cont_id' \ -d 'create_time=2015-01-01+12%3A00%3A00' \ -d 'daren_nickname=abc' \ -d 'daren_pid=mm_12345_0_0' \ -d 'extra=123' \ -d 'interact_number=123' \ -d 'item_list=123%2C45' \ -d 'packet_sign=1' \ -d 'read_number=123' \ -d 'weight_sign=1' |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | # -*- coding: utf-8 -*- import top.api req = top.api.TbkMediaDataUploadRequest(url,port) req.set_app_info(top.appinfo(appkey,secret)) req.cont_id = "123" req.cont_url = "taobao.s.click.com_cont_id" req.create_time = "2015-01-01 12:00:00" req.packet_sign = 1 req.weight_sign = 1 req.daren_nickname = "abc" req.daren_pid = "mm_12345_0_0" req.read_number = 123 req.interact_number = 123 req.item_list = "123,45" req.extra = "123" try : resp = req.getResponse() print (resp) except Exception,e: print (e) |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 | pTopRequest pRequest = alloc_top_request(); pTopResponse pResponse = NULL; pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret); set_api_name(pRequest, "taobao.tbk.media.data.upload" ); add_param(pRequest, "cont_id" , "123" ); add_param(pRequest, "cont_url" , "taobao.s.click.com_cont_id" ); add_param(pRequest, "create_time" , "2015-01-01 12:00:00" ); add_param(pRequest, "packet_sign" , "1" ); add_param(pRequest, "weight_sign" , "1" ); add_param(pRequest, "daren_nickname" , "abc" ); add_param(pRequest, "daren_pid" , "mm_12345_0_0" ); add_param(pRequest, "read_number" , "123" ); add_param(pRequest, "interact_number" , "123" ); add_param(pRequest, "item_list" , "123,45" ); add_param(pRequest, "extra" , "123" ); pResponse = top_execute(pClient,pRequest,NULL); printf( "ret code:%d\n" ,pResponse - >code); if (pResponse - >code = = 0 ){ pTopResponseIterator ite = init_response_iterator(pResponse); pResultItem pResultItem = alloc_result_item(); while (parseNext(ite, pResultItem) = = 0 ){ printf( "%s:%s\n" ,pResultItem - >key,pResultItem - >value); } destroy_response_iterator(ite); destroy_result_item(pResultItem); } destroy_top_request(pRequest); destroy_top_response(pResponse); destroy_taobao_client(pClient); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | TopClient = require( './topClient' ).TopClient; var client = new TopClient({ 'appkey' : 'appkey' , 'appsecret' : 'secret' , }); client.execute( 'taobao.tbk.media.data.upload' , { 'cont_id' : '123' , 'cont_url' : 'taobao.s.click.com_cont_id' , 'create_time' : '2015-01-01 12:00:00' , 'packet_sign' : '1' , 'weight_sign' : '1' , 'daren_nickname' : 'abc' , 'daren_pid' : 'mm_12345_0_0' , 'read_number' : '123' , 'interact_number' : '123' , 'item_list' : '123,45' , 'extra' : '123' }, function(error, response) { if (!error) console.log(response); else console.log(error); }) |
1 2 | < tbk_media_data_upload_response > </ tbk_media_data_upload_response > |
1 2 3 4 | { "tbk_media_data_upload_response" :{ } } |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
1 2 3 4 5 6 7 8 | { "error_response" :{ "msg" : "Remote service error" , "code" :50, "sub_msg" : "非法参数" , "sub_code" : "isv.invalid-parameter" } } |
错误码 | 错误描述 | 解决方案 |
---|