关于万邦淘宝/天猫获得店铺的所有商品 API 的解析说明

145 阅读10分钟

item_search_shop-获得店铺的所有商品  注册开通

onebound.taobao.item_search_shop

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:shop_id=57301063&page=1&sort=

参数说明: shop_id:shop_id page:页码
sort:排序[new,bid,sale]
(new 新品,bid:价格,sale:销量,bid加_前缀为从大到小排序)

响应参数

Version: Date:

名称类型必须示例值描述
num_iidBigint0商品ID
pic_urlString0图片地址
titleString0店铺标题
orginal_priceString0优惠价
priceFloat0价格
salesInt0销量
detail_urlString0宝贝链接

请求示例

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

响应示例

	"items": {
		"shop_id": "57301063",
		"page": "1",
		"real_total_results": "389",
		"total_results": "389",
		"page_size": 30,
		"page_count": 13,
		"_ddf": "ti",
		"item": [
			{
				"num_iid": "575585063487",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01QcINEu1yXM5Fc4Rum_!!126446588-0-lubanu-s.jpg",
				"title": "联想有线鼠标M120Pro台式机笔记本电脑鼠标办公家用商务便携鼠标",
				"promotion_price": "19.90",
				"price": "99.00",
				"sales": 459009,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=575585063487"
			},
			{
				"num_iid": "596221008221",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01OiMTME1yXM5VDlGx1-126446588.jpg",
				"title": "联想Handle无线静音鼠标无声办公笔记本台式机电脑鼠标女生白色",
				"promotion_price": "49.90",
				"price": "99.00",
				"sales": 374407,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=596221008221"
			},
			{
				"num_iid": "635069905186",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01VH5bCv1yXM2QjsNDw_!!126446588.jpg",
				"title": "联想小新 无线蓝牙静音鼠标 多彩Plus静音版笔记本台式机电脑鼠标",
				"promotion_price": "59.00",
				"price": "99.00",
				"sales": 321356,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=635069905186"
			},
			{
				"num_iid": "629480018722",
				"pic_url": "//img.alicdn.com/imgextra/i1/0/O1CN01zKuL4E1yXM5T17ihO_!!0-item_pic.jpg",
				"title": "【立即抢购】联想平板电脑小新Pad 2022 10.6英寸 网课平板 学习娱乐 护眼平板电脑学生用 联想官方安卓平板",
				"promotion_price": "1199.00",
				"price": "1199.00",
				"sales": 188681,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=629480018722"
			},
			{
				"num_iid": "523906503171",
				"pic_url": "//img.alicdn.com/imgextra/i4/126446588/O1CN01LOuTsb1yXM5Q72v3j-126446588.jpg",
				"title": "【热销爆款】联想移动硬盘F308 1T usb3.0高速传输移动便携外接",
				"promotion_price": "329.00",
				"price": "569.00",
				"sales": 172431,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=523906503171"
			},
			{
				"num_iid": "643275459619",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01CAIwA51yXM5WskUWX-126446588.jpg",
				"title": "【16英寸大屏】联想小新Pro16 锐龙版 笔记本电脑16英寸2.5K大屏 轻薄本大学生电脑办公游戏设计PS作图电脑",
				"promotion_price": "5799.00",
				"price": "6228.00",
				"sales": 101780,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=643275459619"
			},
			{
				"num_iid": "534562159953",
				"pic_url": "//img.alicdn.com/imgextra/i1/126446588/O1CN01oBN9gd1yXM5TyvtS3-126446588.jpg",
				"title": "联想无线鼠标静音N911Pro家用办公台式机笔记本电脑通用鼠标女生",
				"promotion_price": "59.00",
				"price": "99.00",
				"sales": 96184,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=534562159953"
			},
			{
				"num_iid": "582438538464",
				"pic_url": "//img.alicdn.com/imgextra/i1/126446588/O1CN010n0opD1yXLvblp9q6_!!126446588-0-lubanu-s.jpg",
				"title": "联想无线键盘鼠标套装KN101笔记本台式电脑办公家用磨砂键盘",
				"promotion_price": "68.80",
				"price": "99.00",
				"sales": 95767,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=582438538464"
			},
			{
				"num_iid": "553189240060",
				"pic_url": "//img.alicdn.com/imgextra/i4/126446588/O1CN01PMSxGd1yXM5LZ9Cvq-126446588.jpg",
				"title": "【12代酷睿新品】联想天逸510S 小台机7.4L小机箱 台式机电脑家用 办公采购台式主机电脑 选搭21.5/23显示器",
				"promotion_price": "2599.00",
				"price": "3099.00",
				"sales": 92221,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=553189240060"
			},
			{
				"num_iid": "568618479089",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01q2OyOH1yXM5U3jDlo-126446588.jpg",
				"title": "【听声辩位】联想Y360拯救者耳机头戴式耳机电竞游戏耳麦电脑办公",
				"promotion_price": "139.00",
				"price": "399.00",
				"sales": 78503,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=568618479089"
			},
			{
				"num_iid": "594813040544",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01HIK7DN1yXM5U3gGov-126446588.jpg",
				"title": "联想U04usb扩展器3.0高速笔记本电脑转接头集线器HUB4口USB拓展坞",
				"promotion_price": "49.00",
				"price": "99.00",
				"sales": 75390,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=594813040544"
			},
			{
				"num_iid": "640835814817",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01DD5LRZ1yXM5RFsJGP-126446588.jpg",
				"title": "【热卖爆款】联想小新Air14/Air15 英特尔酷睿i5笔记本电脑 可选14/15.6英寸全面屏高性能学习办公便携轻薄本",
				"promotion_price": "5299.00",
				"price": "5348.00",
				"sales": 71586,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=640835814817"
			},
			{
				"num_iid": "616840904849",
				"pic_url": "//img.alicdn.com/imgextra/i4/126446588/O1CN01LL45HQ1yXM5Pq4mLh-126446588.jpg",
				"title": "联想拯救者Y7000P/Y7000 英特尔酷睿i5 独显电竞本15.6英寸学生办公设计游戏笔记本电脑",
				"promotion_price": "6399.00",
				"price": "6399.00",
				"sales": 68667,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=616840904849"
			},
			{
				"num_iid": "581272947849",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01jltsDF1yXLydK4U4E_!!126446588-0-lubanu-s.jpg",
				"title": "【搭配天逸510】联想19.5英寸/21.5英寸/23英寸显示器家用办公",
				"promotion_price": "1000.00",
				"price": "1000.00",
				"sales": 67949,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=581272947849"
			},
			{
				"num_iid": "644081824778",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01CWCaZK1yXM5PCD13T-126446588.jpg",
				"title": "【店铺爆款】联想笔记本拯救者R9000P R7独显RTX30系独显 大屏游戏本电竞本 学生办公设计笔记本电脑热销",
				"promotion_price": "8599.00",
				"price": "8599.00",
				"sales": 67095,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=644081824778"
			},
			{
				"num_iid": "582041089322",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01kGKj3N1yXM5VDhz3O-126446588.jpg",
				"title": "联想双模无线蓝牙鼠标 静音小新Air台式机笔记本金属鼠标便携办公",
				"promotion_price": "99.90",
				"price": "129.00",
				"sales": 66216,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=582041089322"
			},
			{
				"num_iid": "595077214220",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN011TatWe1yXM2auZgSM_!!126446588-0-lubanu-s.jpg",
				"title": "联想typec拓展坞笔记本电脑usb扩展器HDMI多功能转接头VGA分线器",
				"promotion_price": "49.00",
				"price": "109.00",
				"sales": 63988,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=595077214220"
			},
			{
				"num_iid": "618440701551",
				"pic_url": "//img.alicdn.com/imgextra/i1/126446588/O1CN017kYVg51yXM5GA6fg7-126446588.jpg",
				"title": "【15.6英寸大屏】联想小新Air15 英特尔酷睿i5 大屏笔记本电脑 商务本学习本办公大学生网课大屏电脑笔记本",
				"promotion_price": "4899.00",
				"price": "5299.00",
				"sales": 61067,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=618440701551"
			},
			{
				"num_iid": "644166620521",
				"pic_url": "//img.alicdn.com/imgextra/i4/126446588/O1CN01fVEk3M1yXM5QWEnzW-126446588.jpg",
				"title": "【爆款平板】联想平板电脑小新Pad Plus 2023 11.5英寸高清全面屏 安卓学习办公娱乐 护眼学生网课平板电脑",
				"promotion_price": "1799.00",
				"price": "1799.00",
				"sales": 59708,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=644166620521"
			},
			{
				"num_iid": "574157068297",
				"pic_url": "//img.alicdn.com/imgextra/i4/126446588/O1CN01ln3RtW1yXM1puzaPq_!!126446588-0-lubanu-s.jpg",
				"title": "联想外置光驱8倍速GP70N光盘DVD刻录机MAC外接移动光驱盒多兼容",
				"promotion_price": "199.00",
				"price": "299.00",
				"sales": 56606,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=574157068297"
			},
			{
				"num_iid": "575849609664",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01QsmCER1yXM5O7wD1L-126446588.jpg",
				"title": "联想拯救者便携散热支架Z3 金属铝合金桌面散热底座 电脑支架笔记本支架",
				"promotion_price": "129.00",
				"price": "129.00",
				"sales": 55190,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=575849609664"
			},
			{
				"num_iid": "554344616776",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01QNvrTi1yXM5LOVTc0-126446588.jpg",
				"title": "联想笔记本电脑清洁套装键盘清理手机屏幕清洁剂清灰显示器工具",
				"promotion_price": "49.00",
				"price": "79.00",
				"sales": 48625,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=554344616776"
			},
			{
				"num_iid": "523931469182",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01D8TlCi1yXLqhQqfUP_!!126446588.jpg",
				"title": "联想K5819黑/白有线键盘轻薄usb办公家用 笔记本台式机电脑通用",
				"promotion_price": "68.80",
				"price": "99.00",
				"sales": 48301,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=523931469182"
			},
			{
				"num_iid": "674626793026",
				"pic_url": "//img.alicdn.com/imgextra/i2/0/O1CN01FM34zw1yXM5N7MdWW_!!0-item_pic.jpg",
				"title": "【立即抢购】联想小新平板电脑小新Pad 2022学生学习 网课平板电脑 护眼娱乐办公平板电脑联想平板电脑学生用",
				"promotion_price": "1199.00",
				"price": "1199.00",
				"sales": 44890,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=674626793026"
			},
			{
				"num_iid": "641388463699",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN01u7fuE71yXM5VjPTRy-126446588.jpg",
				"title": "【店铺爆款】联想笔记本电脑拯救者R9000P RTX30系显卡 16英寸电竞游戏学生办公笔记本联想官方旗舰店",
				"promotion_price": "8599.00",
				"price": "8599.00",
				"sales": 37803,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=641388463699"
			},
			{
				"num_iid": "640712201090",
				"pic_url": "//img.alicdn.com/imgextra/i1/126446588/O1CN014w9O6G1yXM5N1NuQb-126446588.jpg",
				"title": "联想拯救者R7000/R7000P 15.6英寸大屏游戏本笔记本电脑 独显电竞本学生办公设计电脑",
				"promotion_price": "6299.00",
				"price": "6499.00",
				"sales": 37507,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=640712201090"
			},
			{
				"num_iid": "606699574825",
				"pic_url": "//img.alicdn.com/imgextra/i4/126446588/O1CN015pB0wV1yXM5U3iHZi-126446588.jpg",
				"title": "联想Howard蓝牙无线鼠标充电款笔记本电脑家用办公便携鼠标通用",
				"promotion_price": "59.90",
				"price": "99.00",
				"sales": 36977,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=606699574825"
			},
			{
				"num_iid": "653173825693",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01fIRA3e1yXM5UiLi6f-126446588.jpg",
				"title": "联想小新便携散热支架 金属铝合金散热支架 笔记本支架电脑支架",
				"promotion_price": "69.00",
				"price": "149.00",
				"sales": 36048,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=653173825693"
			},
			{
				"num_iid": "587160367479",
				"pic_url": "//img.alicdn.com/imgextra/i3/126446588/O1CN01SlUz6N1yXLpfCwdpd_!!126446588.jpg",
				"title": "【补差价专拍】其他用途请不要拍!联想智能门锁E1霸王锁体、王力锁体、小帅锁体差价",
				"promotion_price": "199.00",
				"price": "199.00",
				"sales": 34548,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=587160367479"
			},
			{
				"num_iid": "630919836622",
				"pic_url": "//img.alicdn.com/imgextra/i2/126446588/O1CN0151hg7p1yXM5S1b0WS-126446588.jpg",
				"title": "联想小新Pad/Pad Plus/Pad Pro/拯救者Y700 2021/2022版 平板电脑保护夹可选 平板保护套保护外壳",
				"promotion_price": "69.00",
				"price": "149.00",
				"sales": 34497,
				"seller_nick": "联想官方旗舰店",
				"shop_id": "57301063",
				"shop_title": "联想官方旗舰店",
				"detail_url": "https://item.taobao.com/item.htm?id=630919836622"
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "930775083fcc5da4f500f683299776e7",
	"secache_time": 1672708282,
	"secache_date": "2023-01-03 09:11:22",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:23 max:10000 all[43=23+1+19];expires:2030-12-31",
	"execution_time": "0.566",
	"server_time": "Beijing/2023-01-03 09:11:22",
	"client_ip": "106.6.36.102",
	"call_args": {
		"seller_nick": "57301063",
		"start_price": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "1.02MB",
	"request_id": "gw-4.63b380b99a5d9",
	"last_id": "1451641158"
}

异常示例相关资料错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误