获取淘宝店铺的所有商品API 返回值说明

25 阅读5分钟

​           API是应用程序的开发接口,在开发程序的时候,我们有些功能可能不需要从到到位去研发,我们可以拿现有的开发出来的功能模块来使用,而这个功能模块,就叫做库(libary)。比如说:要实现数据传输的安全,这就要使用加密技术,使用加密技术就要用到加密算法,而加密算法,已经有好心人,帮我们开发出来了加密算法库,你直接就可以调用,不需要再开发算法。

1、公共参数

请求地址:api-gw.onebound.cn/taobao/item…

名称类型必须描述
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版本

2、请求参数

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

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

3、响应参数

Version: Date:

名称类型必须示例值描述
num_iidBigint0579813460997商品ID
pic_urlString0//img.alicdn.com/bao/uploaded/i3/478952498/O1CN011UK7q9WzgFGKQw8_!!478952498.jpg图片地址
titleString0英伦小皮鞋女复古2020秋冬新款网红毛毛鞋女百搭外穿粗跟中跟单鞋店铺标题
orginal_priceString0398.00优惠价
priceFloat0148价格
salesInt07销量
detail_urlString0//item.taobao.com/item.htm?id=579813460997宝贝链接

4、响应示例

{"items": {
		"shop_id": "433655136",
		"page": "1",
		"has_next_page": "true",
		"real_total_results": "89",
		"total_results": "89",
		"page_size": 17,
		"page_count": 5,
		"_ddf": "ti",
		"item": [
			{
				"num_iid": "634344590289",
				"pic_url": "//img.alicdn.com/imgextra/i2/2209411885160/O1CN01Nktron1nzKLJitDtS_!!2209411885160.jpg",
				"title": "SHIPPING邮费/差价 补拍",
				"promotion_price": "1.00",
				"price": "1.00",
				"sales": 20,
				"quantity": "9172",
				"seller_nick": null,
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": null,
				"is_tmall": null,
				"detail_url": "https://item.taobao.com/item.htm?id=634344590289"
			},
			{
				"num_iid": "641715436154",
				"pic_url": "https://img.alicdn.com/imgextra/i4/2209411885160/O1CN016nEPgo1nzKUQAAKGh_!!2209411885160.jpg",
				"title": "IFIK Blue Bicolor Logo Jacket “拼出一片天”短款牛仔夹克外套",
				"promotion_price": "449.00",
				"price": "449.00",
				"sales": 1641,
				"quantity": "169",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=641715436154"
			},
			{
				"num_iid": "642095769499",
				"pic_url": "https://img.alicdn.com/imgextra/i4/2209411885160/O1CN012cGmCD1nzKUZHNhZZ_!!2209411885160.jpg",
				"title": "IFIK denim Bra 2色 小巧却不玲珑的内搭牛仔系带挂脖文胸内衣",
				"promotion_price": "99.00",
				"price": "99.00",
				"sales": 781,
				"quantity": "64",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=642095769499"
			},
			{
				"num_iid": "646885053958",
				"pic_url": "https://img.alicdn.com/imgextra/i2/2209411885160/O1CN01uXcw6z1nzKUT6cwYS_!!2209411885160.jpg",
				"title": "IFIK Blue Double Waist Jeans with Suede双腰头宽松直筒牛仔裤",
				"promotion_price": "428.00",
				"price": "428.00",
				"sales": 607,
				"quantity": "42",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=646885053958"
			},
			{
				"num_iid": "647240758820",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01z9XvZX1nzKUTsSgDp_!!2209411885160.jpg",
				"title": "IFIK "Cowgirl" Print 2-Use Bandana 整一个西部风情的方巾/抹胸",
				"promotion_price": "99.00",
				"price": "99.00",
				"sales": 688,
				"quantity": "147",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=647240758820"
			},
			{
				"num_iid": "653891158457",
				"pic_url": "https://img.alicdn.com/imgextra/i3/2209411885160/O1CN01NKVDC71nzKUTsTLxn_!!2209411885160.jpg",
				"title": "IFIK Tribute to Justin Blazer 90年代经典Y2K牛仔西服西装外套",
				"promotion_price": "629.00",
				"price": "629.00",
				"sales": 1816,
				"quantity": "864",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=653891158457"
			},
			{
				"num_iid": "654317716603",
				"pic_url": "https://img.alicdn.com/imgextra/i2/2209411885160/O1CN01FUBaO61nzKUUtGXld_!!2209411885160.jpg",
				"title": "IFIK Off-shoulder Shirt重塑氛围感的露肩修身复古蓝牛仔衬衫",
				"promotion_price": "379.00",
				"price": "379.00",
				"sales": 971,
				"quantity": "218",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=654317716603"
			},
			{
				"num_iid": "658363512622",
				"pic_url": "https://img.alicdn.com/imgextra/i4/2209411885160/O1CN01DkH2Mk1nzKUT6Twxy_!!2209411885160.jpg",
				"title": "IFIK Black Wrap Jeans 告别含蓄 腰部不对称绑带镂空修身牛仔裤",
				"promotion_price": "399.00",
				"price": "399.00",
				"sales": 1621,
				"quantity": "90",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=658363512622"
			},
			{
				"num_iid": "659434926903",
				"pic_url": "https://img.alicdn.com/imgextra/i2/2209411885160/O1CN01rruOb81nzKUa1M60v_!!2209411885160.jpg",
				"title": "IFIK Black Zip Jeans超模同款长腿两侧口袋拉链式超高腰喇叭裤",
				"promotion_price": "450.00",
				"price": "450.00",
				"sales": 724,
				"quantity": "84",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=659434926903"
			},
			{
				"num_iid": "668871730997",
				"pic_url": "https://img.alicdn.com/imgextra/i1/2209411885160/O1CN01hn5vt01nzKUK1PrA6_!!2209411885160.jpg",
				"title": "IFIK Cargo Pants「工装裤工艺天花板」阔腿口袋洗水牛仔长裤2色",
				"promotion_price": "450.00",
				"price": "450.00",
				"sales": 1169,
				"quantity": "149",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=668871730997"
			},
			{
				"num_iid": "670733077588",
				"pic_url": "https://img.alicdn.com/imgextra/i2/2209411885160/O1CN01aJ3KOP1nzKUYAAbOL_!!2209411885160.jpg",
				"title": "IFIK Leg Belt Bag 'Dressage' 月牙形牛仔暗纹绑带腿包迷你包",
				"promotion_price": "380.00",
				"price": "380.00",
				"sales": 325,
				"quantity": "94",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=670733077588"
			},
			{
				"num_iid": "671047038356",
				"pic_url": "https://img.alicdn.com/imgextra/i3/2209411885160/O1CN016KKPOv1nzKUOkutpV_!!2209411885160.jpg",
				"title": "IFIK Denim Dress 'Mysterious Letter' 蝙蝠牛仔A字抹胸连衣裙",
				"promotion_price": "420.00",
				"price": "420.00",
				"sales": 125,
				"quantity": "62",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=671047038356"
			},
			{
				"num_iid": "671047562893",
				"pic_url": "https://img.alicdn.com/imgextra/i2/2209411885160/O1CN01LOVEVw1nzKUT6Z7I1_!!2209411885160.jpg",
				"title": "IFIK Body Chain 于文文同款 金属与牛仔的碰撞Chocker身体链腰链",
				"promotion_price": "180.00",
				"price": "180.00",
				"sales": 497,
				"quantity": "207",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=671047562893"
			},
			{
				"num_iid": "671369999374",
				"pic_url": "https://img.alicdn.com/imgextra/i4/2209411885160/O1CN014g4ncw1nzKUTsVEUG_!!2209411885160.jpg",
				"title": "IFIK Iconic Soft Terry Set牛仔绣花排钻毛巾料卫衣+喇叭卫裤2色",
				"promotion_price": "320.00",
				"price": "320.00",
				"sales": 698,
				"quantity": "311",
				"seller_nick": "ifiker",
				"seller_id": "2209411885160",
				"shop_id": "433655136",
				"shop_title": "IFIK",
				"is_tmall": "false",
				"detail_url": "https://item.taobao.com/item.htm?id=671369999374"
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "5177b6f4db5be7bfce9032529452fd88",
	"secache_time": 1667785876,
	"secache_date": "2022-11-07 09:51:16",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:10 max:10100 all[34=10+12+12];expires:2030-12-31",
	"execution_time": "2.4",
	"server_time": "Beijing/2022-11-07 09:51:16",
	"client_ip": "106.6.32.214",
	"call_args": {
		"seller_nick": "433655136",
		"start_price": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "6.08MB",
	"request_id": "gw-1.636864929969c",
	"last_id": "1339158195"
}