通过该API可获取官方提供的所有商品库，好券直播，大额券，高佣榜，品牌券，母婴主题，有好货，潮流范，特惠商品，一键转链，且数据实时，使用更便捷
1、【相似推荐】
根据入参字段—(商品ID)item_id，官方会提供该商品的相似商品及排序
注意：要使用以下物料id，请先去“https://pub.alimama.com/——>我的工具——>智能导购API授权”，签订协议后，才可调用。
分类 | material_id |
相似推荐 | 13256 |
2、【猜你喜欢】
根据入参字段—(智能匹配)device_type、device_encrypt、device_value，官方会提供用户个性化的推荐商品及排序
注意：要使用以下物料id，请先去“https://pub.alimama.com/——>我的工具——>智能导购API授权”，签订协议后，才可调用。
分类 | material_id |
含全部商品 | 6708 |
营销商品库商品（此为具备“私域用户管理-会员运营管理功能”的媒体专用） | 28017 |
特色：淘抢购商品库
物料id：34616
接口地址：
http://api.tbk.dingdanxia.com/spk/optimus
在线测试
接口支持https，非大陆服务器（含港澳台）调用接口会出现网络缓慢现象，请联系客服获取国外专线接口
请求参数、 调用方式 GET/POST
参数接口
参数类型
必填
示例
说明
返回参数说明
标记
类型
例子
说明
返回示例
{
"code": 200,
"msg": "请求成功【success】",
"data": [{
"category_id": 50496015,
"click_url": "\/\/s.click.taobao.com\/t?e=m%3D2%26s%3DQEljWCRAsEtw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0D0yr%2BXRGwGyp9OhI%2FAffM6XX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYVMjacS34Cq9I1qc6ZupxAtf4OFyYG8oj%2BwM9ZnCPMlHC2TKqEFvn7i1ezIf87pSBC0JfZhIq3yPICXhDdXVYMwugekJCUMwfiGFCzYOOqAQ&scm=1007.19011.107455.0_4094&pvid=8728c282-be4e-455a-ad90-f50ad0ba3adc&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc;app_pvid:59590_11.23.91.213_34177_1553764915543&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56a",
"commission_rate": "0.6",
"coupon_amount": 10,
"coupon_click_url": "\/\/uland.taobao.com\/coupon\/edetail?e=l1khzliOqEkNfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoJJBc0Nz%2FXIVBtKoeZh%2FMLXLspxGy3zBjaiuj3CzrHp9chouCqZLg4hwdt5TpIjVUa2TCzAtVNtbqwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXjX87iaJhzXLElAxyrvB6mYOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56a",
"coupon_end_time": "1554220799000",
"coupon_remain_count": 99924,
"coupon_share_url": "\/\/uland.taobao.com\/coupon\/edetail?e=l1khzliOqEkNfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoJJBc0Nz%2FXIVBtKoeZh%2FMLXLspxGy3zBjaiuj3CzrHp9chouCqZLg4hwdt5TpIjVUa2TCzAtVNtbqwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXjX87iaJhzXLElAxyrvB6mYOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56a",
"coupon_start_fee": "20.0",
"coupon_start_time": "1553616000000",
"coupon_total_count": 100000,
"item_description": "简约新款 暖色元素 送安装工具",
"item_id": 575377112382,
"level_one_category_id": 50468001,
"level_one_category_name": "手表",
"nick": "型爵手表旗舰店",
"pict_url": "\/\/gw.alicdn.com\/bao\/uploaded\/i2\/3319254258\/O1CN017RIm0B1hKCxIi3bHI_!!0-item_pic.jpg",
"seller_id": 3319254258,
"shop_title": "型爵手表旗舰店",
"small_images": {
"string": ["\/\/img.alicdn.com\/i2\/3319254258\/O1CN011hKCul12FDWcAV4_!!3319254258.jpg", "\/\/img.alicdn.com\/i1\/3319254258\/TB2SskYo5MnBKNjSZFoXXbOSFXa_!!3319254258.jpg", "\/\/img.alicdn.com\/i1\/3319254258\/TB2R1qXpmcqBKNjSZFgXXX_kXXa_!!3319254258.jpg", "\/\/img.alicdn.com\/i1\/3319254258\/O1CN01LwRTjO1hKCvPMg6s2_!!3319254258.jpg"]
},
"title": "迪士尼儿童表带男女款真皮针扣表链配件代用浪琴天梭卡西欧表带女",
"user_type": 1,
"volume": 483,
"white_image": "https:\/\/img.alicdn.com\/imgextra\/TB1TgkCjxnaK1RjSZFBXXcW7VXa.png",
"zk_final_price": "23.9"
}, {
"category_id": 50012668,
"click_url": "\/\/s.click.taobao.com\/t?e=m%3D2%26s%3D8cjHSTWozihw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0D0yr%2BXRGwGyp9OhI%2FAffM6XX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYVMjacS34Cq9I1qc6ZupxAvFEQkgqasihwS1nvmR2uQTC2TKqEFvn7i1ezIf87pSBC0JfZhIq3yP4pI%2FNnogNwshpTeyG8sogyGFCzYOOqAQ&scm=1007.19011.107455.0_4094&pvid=8728c282-be4e-455a-ad90-f50ad0ba3adc&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc;app_pvid:59590_11.23.91.213_34177_1553764915543&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56b",
"commission_rate": "0.3",
"coupon_amount": 10,
"coupon_click_url": "\/\/uland.taobao.com\/coupon\/edetail?e=pEkDGS9XKtANfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoLAtthYTRE17vRAFvUl9U5pLspxGy3zBjaiuj3CzrHp9chouCqZLg4hMsOxv6HVEQ5oxT6gQKB%2FUKwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXrkKb4V2mVawUMYEdA7bi%2FoOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56b",
"coupon_end_time": "1554220799000",
"coupon_remain_count": 100000,
"coupon_share_url": "\/\/uland.taobao.com\/coupon\/edetail?e=pEkDGS9XKtANfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoLAtthYTRE17vRAFvUl9U5pLspxGy3zBjaiuj3CzrHp9chouCqZLg4hMsOxv6HVEQ5oxT6gQKB%2FUKwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXrkKb4V2mVawUMYEdA7bi%2FoOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56b",
"coupon_start_fee": "18.0",
"coupon_start_time": "1553702400000",
"coupon_total_count": 100000,
"item_description": "创意镭射设计卡套",
"item_id": 571524376271,
"level_one_category_id": 50018004,
"level_one_category_name": "文具电教\/文化用品\/商务用品",
"nick": "kinbor旗舰店",
"pict_url": "\/\/gw.alicdn.com\/bao\/uploaded\/i2\/2780232547\/TB2JMlptTdYBeNkSmLyXXXfnVXa_!!2780232547-0-item_pic.jpg",
"seller_id": 2780232547,
"shop_title": "kinbor旗舰店",
"small_images": {
"string": ["\/\/img.alicdn.com\/i2\/2780232547\/TB2sY3LxGSWBuNjSsrbXXa0mVXa_!!2780232547-0-item_pic.jpg", "\/\/img.alicdn.com\/i4\/2780232547\/TB2yoZcpDdYBeNkSmLyXXXfnVXa_!!2780232547.jpg", "\/\/img.alicdn.com\/i1\/2780232547\/TB2ev4nx1OSBuNjy0FdXXbDnVXa_!!2780232547.jpg", "\/\/img.alicdn.com\/i3\/2780232547\/TB2A1MSxFGWBuNjy0FbXXb4sXXa_!!2780232547.jpg"]
},
"title": "kinbor原创镭射卡套卡插公交卡挂脖吊绳工作牌学生饭卡保护套",
"user_type": 1,
"volume": 104,
"white_image": "https:\/\/img.alicdn.com\/imgextra\/TB18pFskMDqK1RjSZSyXXaxEVXa.png",
"zk_final_price": "25"
}]
}
返回错误码说明
错误码
错误描述
解决办法
200
返回成功
-1
数据返回失败
请查看 msg 返回提示
4001
接口秘钥不能为空
请传入接口秘钥
4002
接口秘钥出错
登录后台查看接口秘钥是否一致
4003
参数不正确
请检查参数是否符合文档要求
4004
服务已到期请及时续费
登录后台续费
4005
该接口当日调用量已超限
升级套餐
4006
无权调用该接口
升级套餐
4007
接口不存在
4009
点卡已用完
请登录控制台-服务购买-充值点卡
4010
请购买接口次数包才能调用此接口
需充值次数包
4011
次数包已用完，请重新购买
需充值次数包
4012
请求客户端ip未加入白名单
将ip加入白名单
4013
联盟账号授权已过期
请登录控制台【授权管理】下重新授权您的相关账号
4014
PID异常
请登录控制台【授权管理】-【淘宝授权】，检查您的推广位PID是否填写，或是否填写正确。
4015
系统异常
服务端处理异常，请等待......或联系网站在线客服反馈。
4017
请求拒绝
调用请求被拒绝，您的账号状态存在异常，请联系平台管理员解除限制。
