支持入参对应的“推广位”和官方提供的“物料id”,获取指定物料信息和推广链接
接口地址:
http://api.tbk.dingdanxia.com/tbk/super_search_material
在线测试
接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口
请求参数、 调用方式 POST
参数接口
参数类型
必填
示例
说明
返回参数说明
标记
类型
例子
说明
返回示例
{ "code": 200, "msg": "请求成功【success】", "total_results": 157857, "data": [ { "item_basic_info": { "brand_name": "VANCAMEL/西域骆驼", "category_id": 50010158, "category_name": "夹克", "level_one_category_id": 30, "level_one_category_name": "男装", "pict_url": "https://img.alicdn.com/bao/uploaded/i2/2215909379502/O1CN018CZyF92K3yKZybcJE_!!2215909379502.jpg", "provcity": "福建 泉州", "seller_id": 4800944021037088392, "shop_title": "西域骆驼服饰品牌店", "short_title": "", "small_images": { "string": [ "https://img.alicdn.com/i4/2215909379502/O1CN01xRZ3Q82K3yKh3Ad80_!!2215909379502.jpg", "https://img.alicdn.com/i3/2215909379502/O1CN01VQqRm32K3yL1E282f_!!2215909379502.png", "https://img.alicdn.com/i4/2215909379502/O1CN01Of2vK62K3yKeIfljB_!!2215909379502.jpg", "https://img.alicdn.com/i2/2215909379502/O1CN01VopZT12K3yKfp3LI1_!!2215909379502.jpg" ] }, "sub_title": "", "title": "西域骆驼新款户外登山旅游情侣美式冲锋衣防风保暖运动休闲外套", "tk_total_sales": "50", "user_type": 0, "volume": 500, "white_image": "" }, "item_id": "wWGxrbcgtDoN83nYqI39Nsbtd-9OG5WdfOXewBjYbhrQ", "presale_info": { "presale_deposit": "" }, "price_promotion_info": { "final_promotion_path_list": { "final_promotion_path_map_data": [ { "promotion_desc": "满500.01减500", "promotion_end_time": "1706716799000", "promotion_fee": "500", "promotion_id": "0857973e0d6d47499f33076181f55726", "promotion_start_time": "1705161600000", "promotion_title": "商品券" } ] }, "final_promotion_price": "69.9", "promotion_tag_list": { "promotion_tag_map_data": [ { "tag_name": "500元" }, { "tag_name": "包邮" } ] }, "reserve_price": "659.90", "zk_final_price": "569.9" }, "publish_info": { "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3D4L8pFbTA4LFw4vFB6t2Z2ueEDrYVVa64lwnaF1WLQxlyINtkUhsv0HAY4dRTeSoWMo80ymJwxZ%2BXX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYcZfoTD5jAPjoRNfHM0BOv3OoJTgnJNbsutj%2FQQREY2LgTybYfFtzwyoWu%2F2FmcMu9RITYVE%2Blah7jfuM1B8ZZ6aXm0XFZ13crkDp8AHWkMmJit67cAGVFU5FUZ5U0OvsfN2vv8Ma0EJoAzcQG3HvinGJe8N%2FwNpGw%3D%3D&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f09%4001%40eyJmbG9vcklkIjo4MDMwOX0ie", "commission_type": "MKT", "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=13WoZfVvC40NfLV8niU3R0P2gVhX2vi1lyRrA15W%2BoDSWGL28aqHjTvgB0zL82QpDKTrpn6NPbOdrkbOK0AiFiqrfGF0I709y5FOJP2gSFVlXymvoVZzQwNKjzwrr%2FgwqWHD%2FRBKBEOYwek19h0d0JLAbAIYNA39vQtn7YCHiI5oSkAynW0ilVACjPwtVWdsB%2BovwgEXpN6rP8R82Zr%2BoDeYlSGprshDdpqO%2F03DLNdfnkXucjRT5o4wYX6q0KwKcKyGdLFfF%2BPiINPY4XmmYKJ7%2BkHL3AEW&app_pvid=59590_33.7.114.50_58196_1706237865566&ptl=floorId:80309;app_pvid:59590_33.7.114.50_58196_1706237865566;tpp_pvid:ef0d09ae-becf-46f2-9a2f-358d17adb3d4&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f09%4001%40eyJmbG9vcklkIjo4MDMwOX0ie", "income_info": { "commission_amount": "6.29", "commission_rate": "900", "subsidy_amount": "0", "subsidy_rate": "0" }, "income_rate": "9.0" }, "scope_info": { "superior_brand": 0 } }, { "item_basic_info": { "brand_name": "", "category_id": 50008899, "category_name": "羽绒服", "level_one_category_id": 16, "level_one_category_name": "女装/女士精品", "pict_url": "https://img.alicdn.com/bao/uploaded/i2/733734199/O1CN01bL7Mt91gtBxOSuhLK_!!733734199.jpg", "provcity": "浙江 嘉兴", "seller_id": 4829195963715435163, "shop_title": "晴雨雪QYX", "short_title": "", "small_images": { "string": [ "https://img.alicdn.com/i4/733734199/O1CN01rATucT1gtBy0HnE7d_!!733734199.jpg", "https://img.alicdn.com/i3/733734199/O1CN01c6qpJQ1gtBxWq6dcm_!!733734199.jpg", "https://img.alicdn.com/i1/733734199/O1CN01xncX8w1gtBxY0sgLA_!!733734199.jpg", "https://img.alicdn.com/i4/733734199/O1CN01XztdSA1gtBy1PZhyO_!!733734199.jpg" ] }, "sub_title": "", "title": "晴雨雪圆领羽绒服女轻薄短款韩版菱格宽松小个子白鸭绒保暖外套冬", "tk_total_sales": "100", "user_type": 0, "volume": 500, "white_image": "" }, "item_id": "bAozgbugto8jKz6GBUzMRIQt6-ZWQpy8tA9Wp64NKuO2", "presale_info": { "presale_deposit": "" }, "price_promotion_info": { "final_promotion_path_list": { "final_promotion_path_map_data": [ { "promotion_desc": "满300减170", "promotion_end_time": "1706716799000", "promotion_fee": "170", "promotion_id": "5c8a1147090b453b88adbbbc967d9311", "promotion_start_time": "1705492800000", "promotion_title": "商品券" }, { "promotion_desc": "每200减30", "promotion_end_time": "1706716799000", "promotion_fee": "30", "promotion_id": "76011336300-20000-3000", "promotion_start_time": "1705492800000", "promotion_title": "跨店满减" } ] }, "final_promotion_price": "138", "predict_rounding_up_price": "117.3", "predict_rounding_up_price_desc": "需凑单", "promotion_tag_list": { "promotion_tag_map_data": [ { "tag_name": "170元" }, { "tag_name": "每200减30" }, { "tag_name": "包邮" } ] }, "reserve_price": "588.00", "zk_final_price": "338" }, "publish_info": { "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3DfEWvFfcI5fRw4vFB6t2Z2ueEDrYVVa64lwnaF1WLQxlyINtkUhsv0HAY4dRTeSoWMo80ymJwxZ%2BXX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYcZfoTD5jAPjeCRicXXmXIyK7cYgECNa6T9GLwZIH0cp4tBGWqWljMeq3kLM0PSCBvigSS2RF98cmvn0QGfLkNAjtbb1lAkfqhIjP5Uhv22UFGhBLhApIMqkQNbHa5C5fZodOm2iw0gExgxdTc00KD8%3D&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f0a%4001%40eyJmbG9vcklkIjo4MDMwOX0ie", "commission_type": "MKT", "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=OcoluD857EMNfLV8niU3R0P2gVhX2vi111HhX5jcz4gO01iuyTF2TpOoeikG%2FZiD0Zx9mrIAJBmaIgIEbKKFXQpEfeXFu5Udy5FOJP2gSFVlXymvoVZzQyLd7RR5rzEm0tk3gl2YD1iYwek19h0d0JLAbAIYNA39vQtn7YCHiI5oSkAynW0ilVACjPwtVWdsB%2BovwgEXpN6aEUdoZkPltiz0ozPI%2BSxyyBV2ck2ykA8hcf5Wqw0N%2BRRejvUk6PEIO5pjFiQyOfUZao0HO%2FvX0w%3D%3D&app_pvid=59590_33.7.114.50_58196_1706237865566&ptl=floorId:80309;app_pvid:59590_33.7.114.50_58196_1706237865566;tpp_pvid:ef0d09ae-becf-46f2-9a2f-358d17adb3d4&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f0a%4001%40eyJmbG9vcklkIjo4MDMwOX0ie", "income_info": { "commission_amount": "2.48", "commission_rate": "180", "subsidy_amount": "0", "subsidy_rate": "0" }, "income_rate": "1.8" }, "scope_info": { "superior_brand": 0 } } ] }
返回错误码说明
错误码
错误描述
解决办法
200
返回成功
-1
数据返回失败
请查看 msg 返回提示
4001
接口秘钥不能为空
请传入接口秘钥
4002
接口秘钥出错
登录后台查看接口秘钥是否一致
4003
参数不正确
请检查参数是否符合文档要求
4004
服务已到期请及时续费
登录后台续费
4005
该接口当日调用量已超限
升级套餐
4006
无权调用该接口
升级套餐
4007
接口不存在
4009
点卡已用完
请登录控制台-服务购买-充值点卡
4010
请购买接口次数包才能调用此接口
需充值次数包
4011
次数包已用完,请重新购买
需充值次数包
4012
请求客户端ip未加入白名单
将ip加入白名单
4013
联盟账号授权已过期
请登录控制台【授权管理】下重新授权您的相关账号
4014
PID异常
请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。
4015
系统异常
服务端处理异常,请等待......或联系网站在线客服反馈。
4017
请求拒绝
调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。