热销商品库
淘宝客物料精选API接口【升级版】
需要授权
1275人使用

支持入参对应的“推广位”和官方提供的“物料id”，获取指定物料信息和推广链接

接口地址： http://api.tbk.dingdanxia.com/tbk/material_recommend 在线测试

接口支持https，非大陆服务器（含港澳台）调用接口会出现网络缓慢现象，请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

是

接口秘钥，请登录后台获取

material_id

String

是

4092

官方提供的物料Id；物料id汇总贴：https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a

pid

String

否

mm_xx_xx_xx

推广位id

page_size

Number

否

20

页大小，默认20，1~100

page_no

Number

否

1

第几页，默认：1

relation_id

Number

否

渠道关系ID，仅适用于渠道推广场景

item_id

String

否

qeqscd1231-uqwenqe

淘宝客新商品ID；用于相似商品推荐（注意：使用相似商品推荐material_id=13256必传，并请先签署协议https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)；另关于《淘宝客新商品ID升级》参考白皮书：https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud

返回参数说明

标记

类型

例子

说明

item_id

String

商品信息-淘宝客新商品id；使用说明参考《淘宝客新商品ID升级》白皮书：https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud

item_basic_info

BasicMapData

商品基础信息

title

String

商品信息-商品标题

short_title

String

商品信息-商品短标题

pict_url

String

商品信息-商品主图

white_image

String

商品信息-商品白底图

level_one_category_id

Number

商品信息-一级类目ID

level_one_category_name

String

商品信息-一级类目名称

category_id

Number

商品信息-叶子类目id

category_name

String

商品信息-叶子类目名称

seller_id

Number

店铺信息-卖家id

user_type

Number

店铺信息-卖家类型，0表示淘宝，1表示天猫，3表示特价版

shop_title

String

店铺信息-店铺名称

volume

Number

商品信息-30天销量；数据统计截止昨日非实时更新

sub_title

String

商品信息-商品子标题

brand_name

String

商品信息-品牌名称

price_promotion_info

PromotionInfoMapData

价格促销信息

reserve_price

String

商品信息-一口价通常显示为划线价

zk_final_price

String

促销信息-销售价格，无促销时等于一口价，有促销时为促销价。若属于预售商品，付定金时间内，在线售卖价=预售价

final_promotion_price

String

促销信息-预估到手价(元)。若属于预售商品，付定金时间内，预估到手价价=定金+尾款的预估到手价

final_promotion_path_list

FinalPromotionPathMapData[]

到手价优惠路径列表

promotion_title

String

优惠名称，如“商品券”、“跨店满减”、“单品直降”等

promotion_desc

String

优惠利益点文案，如“1件7.92折”、“每200减20”等

promotion_fee

String

实际优惠金额（元）

promotion_start_time

String

优惠开始时间

promotion_end_time

String

优惠结束时间

promotion_id

String

优惠ID

future_activity_promotion_price

String

预热预估到手价（元）

future_activity_promotion_path_list

FutureActivityPromotionPathMapData[]

预热到手价优惠路径列表

promotion_tag_list

PromotionTagMapData[]

标签信息列表

predict_rounding_up_price

String

促销信息-预估凑单价（元）。预估凑单叠加优惠后的商品单价

predict_rounding_up_price_desc

String

促销信息-凑单价说明，描述凑单价的实现说明。如 “可凑单”或“需买X件”

more_promotion_list

MorePromotionMapData[]

更多活动优惠

predict_rounding_up_path_list

PredictRoundingUpPathMapData[]

预估凑单优惠路径

publish_info

PublishInfo

淘客推广信息

income_rate

String

商品信息-收入比率(%)；商品佣金比率+补贴比率

click_url

String

链接-宝贝推广链接

coupon_share_url

String

链接-宝贝+券二合一页面链接

sp_campaign_list

SpCampaign[]

定向计划集合-仅支持联系商务或运营小二申请定向计划合集字段权限

sp_cid

String

定向计划活动ID

sp_name

String

定向计划名称

sp_rate

String

定向佣金率

sp_lock_status

String

定向是否锁佣，0=不锁佣 1=锁佣

sp_apply_link

String

定向计划申请链接

sp_status

String

定向计划是否可用 1-可用 0-不可用

future_activity_commission_rate

String

预热活动到手价对应的佣金比率

future_activity_time

String

预热价活动开始时间

income_info

IncomeInfo

商品佣金信息

commission_rate

String

商品佣金比率

commission_amount

String

商品佣金金额

subsidy_rate

String

补贴比率

subsidy_amount

String

补贴金额

subsidy_upper_limit

String

补贴上限；仅在单笔订单命中补贴上限时返回结果否则出参为空

cpa_reward_type

String

额外奖励活动类型，如果一个商品有多个奖励类型，返回结果使用空格分割，0=预售单单奖励，1=618超级U选单单补

cpa_reward_amount

String

额外奖励活动金额，活动奖励金额的类型与cpa_reward_type字段对应，如果一个商品有多个奖励类型，返回结果使用空格分割

tmall_rank_info

TmallRankInfo

天猫榜单信息

tmall_rank_text

String

白茶热销榜·第5名

榜单排行描述

tmall_rank_url

String

榜单url

presale_info

PresaleInfo

预售信息

presale_start_time

Number

预售商品-付定金开始时间（毫秒）

presale_end_time

Number

预售商品-付定金结束时间（毫秒）

presale_tail_start_time

Number

预售商品-付尾款开始时间（毫秒）

presale_tail_end_time

Number

预售商品-付尾款结束时间（毫秒）

presale_deposit

String

预售商品-定金（元）

presale_discount_fee_text

String

预售商品-优惠信息

favorites_info

FavoritesInfo

选品库信息

topn_info

TopNInfoDTO

前N件佣金信息-前N件佣金生效或预热时透出以下字段

topn_quantity

Number

前N件剩余库存

topn_total_count

Number

前N件初始总库存

topn_start_time

String

前N件佣金开始时间

topn_end_time

String

前N件佣金结束时间

topn_rate

String

前N件佣金率

scope_info

ScopeInfo

商品库范围信息

superior_brand

String

是否品牌精选，0不是，1是

返回示例 
{
    "code": 200,
    "msg": "请求成功【success】",
    "total_results": 84,
    "is_default": "false",
    "data": [
        {
            "item_basic_info": {
                "category_id": 50013875,
                "level_one_category_id": 50013864,
                "level_one_category_name": "饰品/流行首饰/时尚饰品新",
                "pict_url": "//gw.alicdn.com/bao/uploaded/i1/2408235720/TB2SlWZzMaTBuNjSszfXXXgfpXa_!!2408235720.jpg",
                "seller_id": 72268711146489506,
                "shop_title": "时玥指间珠宝",
                "sub_title": "",
                "title": "彩色宝石粉钻戒指女 莫桑圆形微镶纯银镀铂金结婚戒1克拉仿真钻戒",
                "user_type": 0,
                "volume": 10,
                "white_image": "https://img.alicdn.com/imgextra/O1CN01bpfyLh1Rr9myADxo0_!!6000000002164-0-yinhe.jpg"
            },
            "item_id": "k0oJwMcYta06nN8WMhByDhPtJ-Wk7XrAsNDJdojvyTmo",
            "presale_info": [],
            "price_promotion_info": {
                "reserve_price": "452.00",
                "zk_final_price": "226"
            },
            "publish_info": {
                "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3DGAf3p3ceteFw4vFB6t2Z2ueEDrYVVa64juWlisr3dOdyINtkUhsv0HAY4dRTeSoWKzNVG%2FFN4cCXX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYVMjacS34Cq9I1qc6ZupxAt7B2NJP%2B9WcGVBdVmokXxpaRh7iblkjqqbWJl2siIO6j8J80znaqV01dSxF5fdkpQC2n8XT8FavI53rq%2BqHOT6uPwKbyPejWYHo5io5np4qb9egITPsLwnUJq9n%2BC%2FxjxxKmPmpIKZsA%3D%3D&scm=1007.19011.107453.0_4092&pvid=4a9f0431-7033-4b27-90f0-457bad943f9c&app_pvid=59590_33.7.202.248_886_1706237807991&ptl=floorId:4092;originalFloorId:4092;pvid:4a9f0431-7033-4b27-90f0-457bad943f9c;app_pvid:59590_33.7.202.248_886_1706237807991&union_lens=lensId%3AMAPI%401706237808%402107caf8_1283_18d43b2cda0_148b%4001%40eyJmbG9vcklkIjo0MDkyfQieie%3Bscm%3A1007.19011.107453.0_4092",
                "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=9Z9kFCdNMUkNfLV8niU3R5TgU2jJNKOfc4SfXBF8mZpgn20rKdMMKYZpn10i7w1JQpZMxTncWcSidl4xmJ0lfD5cZqYavHuuJlvbChrb3i5a4rBpq3tSHdARQKkTg7tdqLP7taj59MsVTp%2BvkBmolh55pVu4YJmiWbKNV%2Bj2e7ES1k0LIVPLzrWIIgVZ05WVggfJBfHCFr1CrIfPkAz9tLdwxE5%2BGKLNC9GQ6bmOLDEWZBNtAcRTQJy0OPVsuWqTM%2FdJqKvN9q0%3D&app_pvid=59590_33.7.202.248_886_1706237807991&ptl=floorId:4092;app_pvid:59590_33.7.202.248_886_1706237807991;tpp_pvid:4a9f0431-7033-4b27-90f0-457bad943f9c&union_lens=lensId%3AMAPI%401706237808%402107caf8_1283_18d43b2cda0_148b%4001%40eyJmbG9vcklkIjo0MDkyfQieie%3Bscm%3A1007.19011.107453.0_4092",
                "income_info": [],
                "income_rate": "0.9"
            },
            "scope_info": []
        },
        {
            "item_basic_info": {
                "category_id": 50012772,
                "level_one_category_id": 1625,
                "level_one_category_name": "女士内衣/男士内衣/家居服",
                "pict_url": "//gw.alicdn.com/bao/uploaded/i1/3701397014/O1CN01dqN8Jz21gSa9MQyDH_!!0-item_pic.jpg",
                "seller_id": 108299316342426761,
                "shop_title": "黛妃乐旗舰店",
                "sub_title": "【已抢50万套】【珊瑚绒保暖】【赠运费险】",
                "title": "珊瑚绒睡衣女秋冬季法兰绒套装暖暖家居服冬天2023年新款加厚加绒",
                "user_type": 1,
                "volume": 500,
                "white_image": "https://img.alicdn.com/imgextra/i2/6000000007362/O1CN01R12SUA24FqT6WRnjE_!!6000000007362-0-yinhe.jpg"
            },
            "item_id": "JPjQDrCRtqM0DQ65etY3oCvta-k5Wd8bFg36Yv6RDUkp",
            "presale_info": [],
            "price_promotion_info": {
                "reserve_price": "99.00",
                "zk_final_price": "59"
            },
            "publish_info": {
                "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3DXeC5ndlM%2BR1w4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0HAY4dRTeSoWKzNVG%2FFN4cCXX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYVMjacS34Cq9I1qc6ZupxAuMRugu2uas8Ou2SFPMIplWDVHFVTT%2B2tsMKa1Z3eTyKj4sz%2Fe%2Bu3esnAgPEgaAXdpPHJ6XMVctGfzmBBBjJ0SwXH5t%2B8W%2BDyVQWQyPx7yrVc%2FrD2eiWJoDUJq9n%2BC%2FxjxxKmPmpIKZsA%3D%3D&scm=1007.19011.107453.0_4092&pvid=4a9f0431-7033-4b27-90f0-457bad943f9c&app_pvid=59590_33.7.202.248_886_1706237807991&ptl=floorId:4092;originalFloorId:4092;pvid:4a9f0431-7033-4b27-90f0-457bad943f9c;app_pvid:59590_33.7.202.248_886_1706237807991&union_lens=lensId%3AMAPI%401706237808%402107caf8_1283_18d43b2cda1_148c%4001%40eyJmbG9vcklkIjo0MDkyfQieie%3Bscm%3A1007.19011.107453.0_4092",
                "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=8d0TWYT41gENfLV8niU3R5TgU2jJNKOfc4SfXBF8mZoK%2BPH0KLhAs7hXX2qG4XPkTZcRNOw5HTJ%2FOJ0ANYuQhsBVNRh8rUE2joryWb13ibpa4rBpq3tSHdARQKkTg7tdBHrVjqhPlOxlt71kooRcDR55pVu4YJmiWbKNV%2Bj2e7ES1k0LIVPLzrWIIgVZ05WVggfJBfHCFr1CrIfPkAz9tB%2BWlQFY3X6lrHpTeh5U3ri4ThFba3PDJ2dRbdFhF4tt5M0kZg5qGOw%3D&app_pvid=59590_33.7.202.248_886_1706237807991&ptl=floorId:4092;app_pvid:59590_33.7.202.248_886_1706237807991;tpp_pvid:4a9f0431-7033-4b27-90f0-457bad943f9c&union_lens=lensId%3AMAPI%401706237808%402107caf8_1283_18d43b2cda1_148c%4001%40eyJmbG9vcklkIjo0MDkyfQieie%3Bscm%3A1007.19011.107453.0_4092",
                "income_info": [],
                "income_rate": "9.0"
            },
            "scope_info": []
        }
    ]
}
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

请查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完，请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】，检查您的推广位PID是否填写，或是否填写正确。

4015

系统异常

服务端处理异常，请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝，您的账号状态存在异常，请联系平台管理员解除限制。

友情链接： 订单侠开放平台  淘宝客高佣转链  淘宝客订单查询  淘口令解析  淘口令生成  二合一链接解析  淘宝客商品详情  淘宝客短连接生成  淘宝联盟商品库  玩淘客playtaoke  淘宝客  MinIO中国  淘宝卖家平台  淘客app  淘宝客app  订单侠开放平台技术博客  聚推客联盟  反恶联盟