万邦淘宝/天猫获取推荐商品列表 API 返回值说明

item_recommend-获取推荐商品列表

onebound.taobao.item_recommend

公共参数

请求地址: console.open.onebound.cn/console/?i=… 注册享任意接口免费测试3天

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：type=

参数说明：type:推荐类型

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	春秋季长袖睡衣女 100 纯棉V领全棉休闲家居服秋冬女士套装可外穿	宝贝标题
num_iid	Bigint	0	575382424992	宝贝ID
price	Float	0	329.00	价格
sales	Int	0	31	销量
orginal_price	Float	0	329.00	原价
promotion_price	Float	0	118.00	优惠价
pic_url	String	0	img.alicdn.com/bao/uploade…	宝贝图片
detail_url	String	0	detail.tmall.com/item.htm?id…	宝贝链接
commission_rate	Float	0	310.00
coupon_start_time	Date	0	2020-12-13	开始时间
coupon_end_time	Date	0	2020-12-19	结束时间
coupon_info	String	0	满89元减5元	所在地
provcity	String	0	河南 郑州	所在地
seller_id	Bigint	0	2980881979	卖家ID
seller_nick	String	0	耶蒂旗舰店	掌柜昵称
shop_title	String	0	耶蒂旗舰店	店铺名
images	Mix	0	{"img.alicdn.com/i4/29808819…	图片地址

请求示例

• [Curl]
• [PHP]
• [PHPsdk]
• [JAVA]
• [C#]
• [Python]

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_recommend/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&type="

响应示例

获取key和secret

Result Object:

{ "data_from": "top", "item": [ { "title": "森马双肩包女新款初中生中学生背包男高中生电脑包女生大学生书包", "num_iid": 534708761957, "price": "79.99", "sales": 6000, "orginal_price": "198", "promotion_price": "79.99", "pic_url": "img.alicdn.com/bao/uploade…", "area": "浙江 杭州", "seller_id": 2883773964, "seller_nick": "森马箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "MIUI/小米小米双肩包书包男女笔记本电脑包时尚潮流旅行背包", "num_iid": 44932380380, "price": "149", "sales": 2000, "orginal_price": "149", "promotion_price": "149", "pic_url": "img.alicdn.com/bao/uploade…", "area": "北京", "seller_id": 1714128138, "seller_nick": "小米官方旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "卡拉羊双肩包男高中生中学生书包初中生女大容量轻便休闲旅行背包", "num_iid": 18997118608, "price": "119", "sales": 500, "orginal_price": "269", "promotion_price": "119", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 廊坊", "seller_id": 1666003591, "seller_nick": "桓达兴盛箱包专营店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "卡拉羊小学生中学生初中生书包女双肩包大容量小清新时尚可爱潮流", "num_iid": 544061518871, "price": "109", "sales": 58, "orginal_price": "258", "promotion_price": "109", "pic_url": "img.alicdn.com/bao/uploade…", "area": "浙江 杭州", "seller_id": 1872229979, "seller_nick": "卡拉羊深圳专卖店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "耐克正品nike运动双肩背包学生轻便书包男女款户外旅行包BA5217", "num_iid": 560434476465, "price": "139", "sales": 500, "orginal_price": "299", "promotion_price": "139", "pic_url": "img.alicdn.com/bao/uploade…", "area": "湖南 长沙", "seller_id": 1606294705, "seller_nick": "柚子鱼22", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "李宁CF双肩背包男旅行潮流学生高中初中书包户外登山运动包电脑包", "num_iid": 604199049689, "price": "258", "sales": 200, "orginal_price": "399", "promotion_price": "258", "pic_url": "img.alicdn.com/bao/uploade…", "area": "上海", "seller_id": 92688455, "seller_nick": "李宁官方网络旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "Skechers斯凯奇 书包轻便男生电脑运动包高中生大学生女生双肩包", "num_iid": 618427377431, "price": "129", "sales": 10000, "orginal_price": "199", "promotion_price": "129", "pic_url": "img.alicdn.com/bao/uploade…", "area": "上海", "seller_id": 2129855716, "seller_nick": "skechers运动旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "巴布豆书包小学生女孩1-3-6一二三到六年级儿童双肩背包减负护脊4", "num_iid": 593823312634, "price": "78", "sales": 100, "orginal_price": "158", "promotion_price": "78", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 353498289, "seller_nick": "490581190wo", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "儿童书包小学生男女一二三到六年级四五防水护脊双肩背包轻便减负", "num_iid": 619703166145, "price": "55", "sales": 4000, "orginal_price": "158", "promotion_price": "55", "pic_url": "img.alicdn.com/bao/uploade…", "area": "湖南 邵阳", "seller_id": 2208159898240, "seller_nick": "迪帅旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "卡拉羊儿童书包1-6年级小学生轻量减负护脊防水双肩包大容量韩版", "num_iid": 525528927396, "price": "219", "sales": 41, "orginal_price": "388", "promotion_price": "219", "pic_url": "img.alicdn.com/bao/uploade…", "area": "江苏 宿迁", "seller_id": 733274178, "seller_nick": "卡拉羊官方旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "迪士尼书包小学生男生超轻男孩一三到六年级男童美国队长儿童背包", "num_iid": 554635387804, "price": "119", "sales": 100, "orginal_price": "469", "promotion_price": "119", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 中山", "seller_id": 3011075680, "seller_nick": "disney迪士尼联众专卖店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "cai超薄平板电脑背包男出差商务双肩包程序员15寸14笔记本书包男", "num_iid": 558992293125, "price": "149", "sales": 26, "orginal_price": "368", "promotion_price": "149", "pic_url": "img.alicdn.com/bao/uploade…", "area": "福建 厦门", "seller_id": 1740437160, "seller_nick": "cai旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "嘻哈潮牌国潮透明双肩包街头潮流学生书包大容量旅行背包男女时尚", "num_iid": 582093583400, "price": "57.8", "sales": 200, "orginal_price": "158", "promotion_price": "57.8", "pic_url": "img.alicdn.com/bao/uploade…", "area": "北京", "seller_id": 1702834696, "seller_nick": "3man_far", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "书包女ins风双肩包男时尚潮流韩版原宿高中大学生潮牌大容量背包", "num_iid": 607397341523, "price": "44.9", "sales": 100, "orginal_price": "245", "promotion_price": "44.9", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 2102873891, "seller_nick": "满江红箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "韩版男士帆布双肩包初中大学生书包复古电脑背包大容量旅行包男包", "num_iid": 41775901770, "price": "88", "sales": 53, "orginal_price": "219", "promotion_price": "88", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 2102873891, "seller_nick": "满江红箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "潮牌卷盖双肩包大容量男旅游登山包户外休闲旅行背包变形书包电脑", "num_iid": 564479324860, "price": "100", "sales": 21, "orginal_price": "216", "promotion_price": "100", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 广州", "seller_id": 3038978975, "seller_nick": "landcase旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "wheelybaby儿童幼儿园书包男童女孩汽车背包可爱小宝宝轻便双肩包", "num_iid": 601005403041, "price": "325", "sales": 100, "orginal_price": "338", "promotion_price": "325", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 东莞", "seller_id": 2206402422197, "seller_nick": "wheelybaby旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "多妙屋书包小学生男孩一三到六年级男童轻便大容量儿童减负双肩包", "num_iid": 584967672589, "price": "56", "sales": 56, "orginal_price": "228", "promotion_price": "56", "pic_url": "img.alicdn.com/bao/uploade…", "area": "江苏 无锡", "seller_id": 704578281, "seller_nick": "多妙屋母婴旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "Herschel赫行 Dawson双肩包书包潮牌迷你休闲背包旅行包", "num_iid": 545056739376, "price": "493", "sales": 36, "orginal_price": "548", "promotion_price": "493", "pic_url": "img.alicdn.com/bao/uploade…", "area": "上海", "seller_id": 3083173120, "seller_nick": "herschel旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "Bansusu.2022新款卡通印花书包女韩版高中初中双肩包女背包旅行包", "num_iid": 603181881678, "price": "69", "sales": 42, "orginal_price": "185", "promotion_price": "69", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 广州", "seller_id": 1946682323, "seller_nick": "bansusu旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "MoonRock梦乐书包男女生小学生一二年级护脊减负安全反光儿童书包", "num_iid": 600621477336, "price": "569", "sales": 100, "orginal_price": "830", "promotion_price": "569", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 深圳", "seller_id": 4289750789, "seller_nick": "梦乐企业店", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "篮球包训练包篮球袋网ins风大容量学生书包多功能运动背包双肩包", "num_iid": 590129520486, "price": "49", "sales": 50, "orginal_price": "158", "promotion_price": "49", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 2102873891, "seller_nick": "满江红箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "初中生书包女小学生高中学生大容量夏大学生帆布2021年新款双肩包", "num_iid": 42570987198, "price": "39", "sales": 39, "orginal_price": "138", "promotion_price": "39", "pic_url": "img.alicdn.com/bao/uploade…", "area": "安徽 合肥", "seller_id": 1971676541, "seller_nick": "合肥雨凡箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "Gaston Luga吴宇恒同款电脑双肩包男皮大容量书包男潮旅行背包女", "num_iid": 617973653111, "price": "900", "sales": 2000, "orginal_price": "1230", "promotion_price": "900", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 东莞", "seller_id": 2207171788612, "seller_nick": "gastonluga旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "曼哥夫户外旅行炫彩儿童双肩小背包男女休闲轻便学生书包亲子背包", "num_iid": 589581706067, "price": "31.9", "sales": 100, "orginal_price": "78", "promotion_price": "31.9", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 东莞", "seller_id": 2646589786, "seller_nick": "曼哥夫mangrove户外", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "上新小包包双肩包女小清新少女日系软妹帆布斜跨背包百搭迷你书包", "num_iid": 592809285592, "price": "27.8", "sales": 22, "orginal_price": "95", "promotion_price": "27.8", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 465617971, "seller_nick": "madge玛琪包包", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "曼哥夫户外儿童轻便小背包10L男孩子潮旅行旅游双肩背包女童书包", "num_iid": 590650483822, "price": "31.9", "sales": 300, "orginal_price": "78", "promotion_price": "31.9", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 东莞", "seller_id": 4159962113, "seller_nick": "mangrove曼哥夫旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "迷彩儿童背包小学生书包男女孩户外运动休闲轻便旅游旅行双肩背包", "num_iid": 523237926324, "price": "49", "sales": 12, "orginal_price": "128", "promotion_price": "49", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 东莞", "seller_id": 2272760427, "seller_nick": "雨果母婴专营店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "Doughnut双肩包16L甜甜圈石色蓝莲花大容量超轻书包电脑包马卡龙", "num_iid": 578240371671, "price": "409", "sales": 64, "orginal_price": "469", "promotion_price": "409", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 深圳", "seller_id": 700999460, "seller_nick": "tb50525_66", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "港风ins潮牌双肩包男大容量日系简约文艺帆布学生书包潮流背包女", "num_iid": 613829860923, "price": "39.9", "sales": 25, "orginal_price": "158", "promotion_price": "39.9", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 2102873891, "seller_nick": "满江红箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "韩版小清新束口袋抽绳双肩包 男女纯色帆布背包牛仔布袋书包包邮", "num_iid": 566649686884, "price": "7.8", "sales": 61, "orginal_price": "89", "promotion_price": "7.8", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 574647690, "seller_nick": "摩登_小姐", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "书包韩版原宿ulzzang大容量高中双肩包女大学生简约背包男ins潮流", "num_iid": 613711404083, "price": "49.9", "sales": 29, "orginal_price": "188", "promotion_price": "49.9", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 2102873891, "seller_nick": "满江红箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "森马双肩包女夏大学生轻便简约书包高中旅游休闲旅行小背包男时尚", "num_iid": 606231773415, "price": "39.99", "sales": 38, "orginal_price": "159", "promotion_price": "39.99", "pic_url": "img.alicdn.com/bao/uploade…", "area": "浙江 杭州", "seller_id": 1128179151, "seller_nick": "森马集团商城", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "BOPAI博牌轻薄双肩包男背包商务休闲出差电脑包多功能大学生书包", "num_iid": 605150122758, "price": "259", "sales": 12, "orginal_price": "619", "promotion_price": "259", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 广州", "seller_id": 835337664, "seller_nick": "博牌旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "挪威进口Beckmann儿童书包22升L减压护脊护背双肩包小学生1-3年级", "num_iid": 569611052815, "price": "718", "sales": 32, "orginal_price": "900", "promotion_price": "718", "pic_url": "img.alicdn.com/bao/uploade…", "area": "浙江 杭州", "seller_id": 390404309, "seller_nick": "yuszx", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "运动背包男嘻哈双肩包潮牌男大容量学生书包时尚潮流高中旅行电脑", "num_iid": 566574921093, "price": "149", "sales": 11, "orginal_price": "149", "promotion_price": "149", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 广州", "seller_id": 2184550021, "seller_nick": "摇滚的眼睛", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "卡拉羊双肩包男女电脑包休闲旅游背包小中高学生书包防水减负校园", "num_iid": 569524801731, "price": "69", "sales": 11, "orginal_price": "338", "promotion_price": "69", "pic_url": "img.alicdn.com/bao/uploade…", "area": "浙江 宁波", "seller_id": 2995378164, "seller_nick": "卡拉羊俊发专卖店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "Samsonite/新秀丽双肩背包新款男女旅行通勤潮流休闲情侣书包 TL3", "num_iid": 580829919158, "price": "989", "sales": 77, "orginal_price": "1480", "promotion_price": "989", "pic_url": "img.alicdn.com/bao/uploade…", "area": "上海", "seller_id": 1737111535, "seller_nick": "恒艺箱包专营店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "翻卷盖背包男双肩包韩版时尚潮流初中学生书包电脑包大容量旅行包", "num_iid": 570044856416, "price": "97.5", "sales": 10, "orginal_price": "216", "promotion_price": "97.5", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 广州", "seller_id": 3038978975, "seller_nick": "landcase旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" }, { "title": "初中小学生帆布书包2-3-4-5-6年级男女孩双肩包四件套补课单肩包", "num_iid": 599407007583, "price": "29.9", "sales": 38, "orginal_price": "29.9", "promotion_price": "29.9", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 928157627, "seller_nick": "麦包纳", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "阿迪达斯书包女NEO双肩包学生2022新款运动校园旅行包粉色HT6777", "num_iid": 568657381243, "price": "169", "sales": 19, "orginal_price": "229", "promotion_price": "169", "pic_url": "img.alicdn.com/bao/uploade…", "area": "广东 深圳", "seller_id": 722183654, "seller_nick": "爱你那一瞬间", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "中号新款休闲双肩包欧美时尚女包尼龙背包多花色学生书包暗袋印花", "num_iid": 559058080441, "price": "69", "sales": 12, "orginal_price": "139", "promotion_price": "69", "pic_url": "img.alicdn.com/bao/uploade…", "area": "江苏 南京", "seller_id": 1100509649, "seller_nick": "双座秋千", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "小号双肩包女包轻便尼龙布欧美时尚背包男女生12年级学生书包精致", "num_iid": 559572445395, "price": "69", "sales": 15, "orginal_price": "136", "promotion_price": "69", "pic_url": "img.alicdn.com/bao/uploade…", "area": "江苏 南京", "seller_id": 1100509649, "seller_nick": "双座秋千", "detail_url": "item.taobao.com/item.htm?id…" }, { "title": "书包男时尚潮流韩版高中大学生潮牌ins初中生大容量背包女双肩包", "num_iid": 607390021817, "price": "54", "sales": 16, "orginal_price": "294", "promotion_price": "54", "pic_url": "img.alicdn.com/bao/uploade…", "area": "河北 保定", "seller_id": 2102873891, "seller_nick": "满江红箱包旗舰店", "detail_url": "detail.tmall.com/item.htm?id…" } ], "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:127 max:10100 all[202=127+54+21];expires:2030-12-31", "execution_time": "0.543", "server_time": "Beijing/2022-08-03 11:57:51", "client_ip": "106.6.35.126", "call_args": [], "api_type": "taobao", "translate_language": "zh-CN", "translate_engine": "google_new", "server_memory": "5.95MB", "request_id": "gw-1.62e9f23f13697", "last_id": "1125078659" }