暂无说明
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
itemid | String | 529048526383 | 是 | 宝贝ID |
pid | String | mm_0000_0000_000 | 是 | 推广位ID(*必须是授权淘宝号下的推广位)(注:如已在会员中心设置了默认PID,此参数可无需再次传入) |
activityid | String | 7d6e6619ff754e1e94ea140e2a82240f | 阿里妈妈推广券ID | |
tbname | String | xxx | 是 | 在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页 |
relation_id | String | 23223 | 是 | 渠道关系ID,仅适用于渠道推广场景(选填)当入参relationId的时候,必须确保adzoneid为对应合作方账号下的专属pid。后台会进行专属pid和relationId进行校验,校验通过才可以正常推广结算,获取说明:https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639(注:如已在会员中心设置了默认渠道ID,此参数可无需再次传入) |
shorturl | Number | 1 | 是否需要短链接,1为生成,不填则不生成 | |
tpwd | Number | 1 | 是否生成淘口令,1为生成,不填则不生成 | |
tpwdpic | String | 商品图片链接,用于打开口令时显示,不填写默认为商品主图 | ||
extsearch | Number | 1 | 官方查不到券时是否去第三方平台查询,1为启用 | |
hasiteminfo | String | 0 | 是否输出商品信息,双十一期间不建议启用,1=启用,0=不启用 | |
special_id | String | 会员运营ID | ||
external_id | String | 淘宝客外部用户标记,如自身系统账户ID;微信ID等 | ||
xid | String | xxxx | 团长与下游渠道合作的特殊标识,用于统计渠道推广效果 | |
qrcode | String | 1 | 是否生成二维码图片,1是生成,其他或不填则不生成 | |
platform | Number | 1 | 1:PC,2:无线,默认:1 | |
get_topn_rate | Number | 1 | 是否获取前N件佣金 ,0-否,1-是,其他值-否 | |
mini_program_link | Number | 0 | 是否需要获取小程序链接,需要设置1。(暂未对外开放) | |
promotion_type | Number | 1-自购省,2-推广赚(代理模式专属ID,代理模式必填,非代理模式不用填写该字段) | ||
biz_scene_id | String | 1 | 1-动态ID转链场景,2-消费者比价场景,3-商品库导购场景(不填默认为1) |
返回参数 | 类型 | 参数说明 | 扩展说明 |
category_id | Number | 商品分类ID | |
coupon_end_time | String | 优惠券有效期截止日期 | 没有优惠券,则此项不显示 |
coupon_info | String | 优惠券信息 | 没有优惠券,则此项不显示 |
coupon_remain_count | String | 优惠券剩余量 | 没有优惠券,则此项不显示 |
coupon_total_count | String | 优惠券总量 | 没有优惠券,则此项不显示 |
coupon_start_time | String | 优惠券开始时间 | 没有优惠券,则此项不显示 |
coupon_type | Number | 优惠券类型 | 1 公开券,2 私有券,3 妈妈券 |
has_coupon | String | 是否有优惠券 | true,有;false,没有 |
coupon_click_url | String | 二合一链接 | |
item_id | String | 商品ID | |
max_commission_rate | String | 高佣金比例 | 当不入参special_id、relation_id、external_id时,展示常规佣金率(%) |
item_url | String | 商品淘客链接 | 同样为高佣,has_coupon为false时,建议使用此链接 |
tpwd | String | 淘口令 | 商品有优惠券时,口令打开为二合一链接页面,无优惠券时,口令打开为商品页面(注:均为高佣金淘客链接,购买之后均有佣金) |
short_url | String | 短链接 | 商品有优惠券时,短链接打开为二合一链接页面,无优惠券时,口令打开为商品页面(注:均为高佣金淘客链接,购买之后均有佣金) |
youhuiquan | Number | 优惠券面额 | 没有优惠券则不显示此字段 |
quanlimit | Number | 优惠券使用条件 | 优惠券使用限制条件,即满xx元使用 |
item_info | Json | 商品信息列表 | |
mm_coupon_remain_count | String | 妈妈优惠券剩余量 | |
mm_coupon_total_count | String | 妈妈优惠券总量 | |
mm_coupon_click_url | String | 商品妈妈优惠券推广链接 | |
mm_coupon_end_time | String | 妈妈优惠券结束时间 | |
mm_coupon_start_time | String | 妈妈优惠券开始时间 | |
mm_coupon_info | String | 妈妈优惠券面额 | |
ysyl_click_url | String | 预售有礼-推广链接 | |
ysyl_tlj_face | String | 预售有礼-预估淘礼金(元) | |
ysyl_tlj_send_time | String | 预售有礼-淘礼金发放时间 | |
ysyl_commission_rate | String | 预售有礼-佣金比例(%) | 预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 |
ysyl_tlj_use_start_time | String | 预售有礼-淘礼金使用开始时间 | |
ysyl_tlj_use_end_time | String | 预售有礼-淘礼金使用结束时间 | |
min_commission_rate | String | 当入参special_id、relation_id、external_id时,该字段展示预估最低佣金率(%) | |
qrcode | String | 二维码图片,有优惠券时为二合一,没有优惠券时为商品单链接 | 可选参数 |
reward_info | String | 比价场景专用,当系统检测到入参消费者ID购买当前商品会获得《天天开彩蛋》玩法的彩蛋时,该字段显示1,否则为0 | |
topn_info | Json | 前N件佣金信息 | 当入参get_topn_rate=1,前N件佣金生效且最高,透出该组字段 |
├ topn_total_count | Number | 前N件初始总库存,当前N件佣金失效,本字段置空(失效:任务完成、时间结束、商品下架) | |
├ topn_quantity | String | 前N件剩余库存,当前N件佣金失效,本字段置空 | |
├ topn_start_time | String | 前N件佣金开始时间,当前N件佣金失效,本字段置空 | |
├ topn_end_time | String | 前N件佣金结束时间, 当前N件佣金 失效,本字段置空 | |
mini_program | Json | 小程序链接(暂未对外开放) | |
├ mini_program_appid | String | 小程序APPID | |
├ mini_program_path | String | 小程序路径 | |
├ mini_program_qrcode_url | String | 小程序码url地址 |
{"code":200,"data":{"category_id":50013886,"coupon_click_url":"https://uland.taobao.com/coupon/edetail?e=hmIte5suv4cGQASttHIxxxxxxxxw","coupon_end_time":"2019-11-16","coupon_info":"满12元减5元","coupon_remain_count":98000,"coupon_start_time":"2019-11-14","coupon_total_count":100000,"coupon_type":3,"item_id":572497732194,"item_url":"https://s.click.taobao.com/t?e=m=2&s=KpCMqSxxxxxxxw","max_commission_rate":"6.00","item_info":{"cat_leaf_name":"毛巾","cat_name":"户外/登山/野营/旅行用品","item_url":"https://detail.tmall.com/item.htm?id=572497732194","material_lib_type":"1,2","nick":"蓓安适旗舰店","num_iid":572497732194,"pict_url":"https://img.alicdn.com/bao/uploaded/i4/642944409/O1CN011DfWoK1iRMpErNsqD_!!0-item_pic.jpg","presale_deposit":"0","presale_end_time":0,"presale_start_time":0,"presale_tail_end_time":0,"presale_tail_start_time":0,"provcity":"上海","reserve_price":"34","seller_id":642944409,"small_images":{"string":["https://img.alicdn.com/i4/642944409/O1CN01s74Bfa1iRMki8AV1p_!!642944409.jpg","https://img.alicdn.com/i3/642944409/O1CN01JLMtav1iRMoDc1d4p_!!642944409.jpg","https://img.alicdn.com/i2/642944409/O1CN01lqPIaU1iRMkfKkhtQ_!!642944409.jpg","https://img.alicdn.com/i4/642944409/O1CN01628EWw1iRMnGcloFU_!!642944409.jpg"]},"title":"蓓安适一次性洗脸巾女纯棉压缩毛巾浴巾旅行酒店便携床单被罩枕套","tmall_play_activity_end_time":0,"tmall_play_activity_start_time":0,"user_type":1,"volume":17268,"zk_final_price":"12"},"has_coupon":true,"short_url":"https://s.click.taobao.com/xxxxxxx","tpwd":"¥Jhxxxxlw¥","youhuiquan":"5","quanlimit":"12"},"msg":"success"}
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |