按关键字搜索淘宝商品 API 返回值说明

83 阅读4分钟

很多电商系统,如返利系统、ERP、OMS软件等,需要通过商品API接口获取商品详情信息,来满足业务场景需要。具体包括: 商品的标题、价格、SKU、主图、评价等维度信息。 重点优化了抓取速度、及抓取稳定性,接口REST方式进行调用,支 持Java、php、python等主流编程语言。 在技术交流群,大家有探讨稳定获取淘宝商品主图、价格、标题,及sku的完整解决方案。这个引起了我技术挑战的兴趣。 目前,自己做了压测,QPS高、出滑块概率极低,API整体稳定,可满足业务场景的性能需求。

 o0b.cn/iturbo  获取key和密钥

公共参数

名称

类型

必须

描述

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版本

请求参数

请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=参数说明:q:搜索关键字cat:分类IDstart_price:开始价格end_price:结束价格sort:排序[bid,_bid,bid2,_bid2,_sale,_credit](bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)page:页数

响应示例:

{
	"items": {
		"page": "1",
		"real_total_results": 2000,
		"total_results": 2000,
		"page_size": 12,
		"pagecount": "100",
		"data_from": "ti",
		"item": [
			{
				"title": "黑色西装外套女春秋款小个子休闲女装春装2023新款职业正装小西服",
				"pic_url": "https://gw.alicdn.com/i1/3630298764/O1CN016LwoMJ2EbxvrbOWYs_!!0-item_pic.jpg",
				"promotion_price": "117.9",
				"price": "117.9",
				"sales": 52,
				"num_iid": "700329646846",
				"seller_nick": "简缇菲旗舰店",
				"seller_id": "3630298764",
				"detail_url": "https://item.taobao.com/item.htm?id=700329646846"
			},
			{
				"title": "红袖衬衫设计感小众冬季2022新款女装显瘦垂感翻领法式上衣高级感",
				"pic_url": "https://gw.alicdn.com/i1/708558593/O1CN01tBMPMQ2DLeCjNsqN2_!!708558593.jpg",
				"promotion_price": "389.0",
				"price": "389.0",
				"sales": 146,
				"num_iid": "686224152783",
				"seller_nick": "红袖官方旗舰店",
				"seller_id": "708558593",
				"detail_url": "https://item.taobao.com/item.htm?id=686224152783"
			},
			{
				"title": "圆领打底衫女内搭早春季2023新款女装百搭高级感修身显瘦长袖上衣",
				"pic_url": "https://gw.alicdn.com/i3/2003789956/O1CN01ybUIgH2NPu2QwMMKz_!!0-item_pic.jpg",
				"promotion_price": "49.9",
				"price": "49.9",
				"sales": 73,
				"num_iid": "698712027841",
				"seller_nick": "森瓦旗舰店",
				"seller_id": "2003789956",
				"detail_url": "https://item.taobao.com/item.htm?id=698712027841"
			},
			{
				"title": "早春新款外套女2023年高级感小个子白色西装设计感小众初春小西服",
				"pic_url": "https://g.search.alicdn.com/img/i4/31625129/O1CN01q2dkLT1nl87Hx6XBy_!!0-saturn_solar.jpg",
				"promotion_price": "389.0",
				"price": "389.0",
				"sales": 0,
				"num_iid": "650083085616",
				"seller_nick": null,
				"seller_id": "852399977",
				"detail_url": "https://item.taobao.com/item.htm?id=650083085616"
			},
			{
				"title": "法式polo领镂空针织开衫女2023新款春秋季设计感小众气质长袖上衣",
				"pic_url": "https://gw.alicdn.com/i1/2455352241/O1CN01JzYyGt1SQQOFdKjVw_!!0-item_pic.jpg",
				"promotion_price": "99.9",
				"price": "99.9",
				"sales": 235,
				"num_iid": "685407903795",
				"seller_nick": "y6y旗舰店",
				"seller_id": "2455352241",
				"detail_url": "https://item.taobao.com/item.htm?id=685407903795"
			},
			{
				"title": "亦谷设计感气质针织衫女2022年冬季新款简约半高领打底衫长袖衬衣",
				"pic_url": "https://gw.alicdn.com/i4/735337687/O1CN01C2XkHD26ehMjsTiKK_!!735337687.jpg",
				"promotion_price": "104.0",
				"price": "104.0",
				"sales": 262,
				"num_iid": "681493229344",
				"seller_nick": "亦谷官方旗舰店",
				"seller_id": "735337687",
				"detail_url": "https://item.taobao.com/item.htm?id=681493229344"
			},
			{
				"title": "熙世界2023春装新款女装法式慵懒风长袖撞色圆领假两件针织衫上衣",
				"pic_url": "https://gw.alicdn.com/i1/765398871/O1CN01uwh8E22FOyJJHmT6p_!!765398871.jpg",
				"promotion_price": "234.0",
				"price": "234.0",
				"sales": 46,
				"num_iid": "698831853414",
				"seller_nick": "sllsky服饰旗舰店",
				"seller_id": "765398871",
				"detail_url": "https://item.taobao.com/item.htm?id=698831853414"
			},
			{
				"title": "西装外套女2023年早春新款小个子休闲绿色高级设计感小众西服上衣",
				"pic_url": "https://g.search.alicdn.com/img/i4/31625129/O1CN01d53rdF1nl8EYxX90m_!!0-saturn_solar.jpg",
				"promotion_price": "589.0",
				"price": "589.0",
				"sales": 0,
				"num_iid": "679152058792",
				"seller_nick": null,
				"seller_id": "852399977",
				"detail_url": "https://item.taobao.com/item.htm?id=679152058792"
			},
			{
				"title": "亦谷复古风高级感休闲裤女2023年春季新款高腰字母抽绳长款阔腿裤",
				"pic_url": "https://gw.alicdn.com/i1/735337687/O1CN01qoBMjC26ehMp1rbWa_!!0-item_pic.jpg",
				"promotion_price": "294.0",
				"price": "294.0",
				"sales": 39,
				"num_iid": "693946730659",
				"seller_nick": "亦谷官方旗舰店",
				"seller_id": "735337687",
				"detail_url": "https://item.taobao.com/item.htm?id=693946730659"
			},
			{
				"title": "美式复古潮牌爱心提花v领毛衣背心女不规则小众设计针织马甲外搭",
				"pic_url": "https://gw.alicdn.com/i3/3937219703/O1CN01LfU8Gs2LY1px1katJ_!!3937219703-0-C2M.jpg",
				"promotion_price": "74.85",
				"price": "74.85",
				"sales": 426,
				"num_iid": "696805676962",
				"seller_nick": "天天特卖工厂店",
				"seller_id": "3937219703",
				"detail_url": "https://item.taobao.com/item.htm?id=696805676962"
			},
			{
				"title": "假两件条纹针织衫女装春秋新款洋气减龄内搭打底小衫时尚气质上衣",
				"pic_url": "https://gw.alicdn.com/i1/3068391740/O1CN01TAZyvg1OixwHsfy9M_!!3068391740.jpg",
				"promotion_price": "26.01",
				"price": "26.01",
				"sales": 152,
				"num_iid": "684825384559",
				"seller_nick": "优雅阁 Shop女装",
				"seller_id": "3068391740",
				"detail_url": "https://item.taobao.com/item.htm?id=684825384559"
			},
			{
				"title": "韩版时尚高级感毛呢中长款宽松翻领撞色开衫外套女",
				"pic_url": "https://g.search2.alicdn.com/img/i2/3880944286/O1CN01DFH1oG1hX2Lm4M4Sg_!!0-saturn_solar.jpg",
				"promotion_price": "115.0",
				"price": "115.0",
				"sales": 0,
				"num_iid": "700986301350",
				"seller_nick": null,
				"seller_id": "2215379599870",
				"detail_url": "https://item.taobao.com/item.htm?id=700986301350"
			}
		],
		"item_weight_update": 0
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "a8881ed5637e3c7e84f03acdc86be64f",
	"secache_time": 1676277664,
	"secache_date": "2023-02-13 16:41:04",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:77 max:10100 all[229=77+95+57];expires:2030-12-31",
	"execution_time": "1.414",
	"server_time": "Beijing/2023-02-13 16:41:04",
	"client_ip": "220.177.180.58",
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "0.93MB",
	"request_id": "gw-4.63e9f79eab88c",
	"last_id": "1546372983"
}