调用API批量获取淘宝商品数据标题价格链接商品类目演示

admin2周前 (03-27)淘宝API33

编辑

淘宝商品详情数据是从选品→定价→运营→供应链→用户→市场的全链路决策依据，既能帮商家提升效率与营收，也能支撑第三方服务、行业研究与技术创新。特别是商品标题、价格、SKU、销量、评价、库存、主图 / 详情图、参数、促销信息等。

taobao.item_get是用于获取单个商品的详情数据的API。通过代码对接可以实现自动批量获取商品数据。

调用示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.服务器.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=1027821174834&is_promotion=1"

调用API后，可获取以下响应数据。

"item": {		"num_iid": "1027821174834",		"title": "迷你猫咪掌心尺高颜值尺子小学生专用便携多功能亚克力绘图直尺",		"desc_short": "",		"price": "3.90",		"total_price": 0,		"suggestive_price": 0,		"orginal_price": "3.90",		"nick": "午后杂物社",		"num": 600,		"min_num": 0,		"detail_url": "https://item.taobao.com/item.htm?id=1027821174834",		"pic_url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN01uOb1hR2Ao6GxqT1FC_!!2220607898249.jpg",		"brand": "无品牌/无注册商标",		"brandId": null,		"rootCatId": null,		"cid": "201853304",		"crumbs": [],		"created_time": "",		"modified_time": "",		"delist_time": "",		"desc": "<div style=\"width: 750.0px;height: auto;overflow: hidden;\"><div style=\"width: 750.0px;height: auto;overflow: hidden;\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01M0ZJI42Ao6GyFzrw2_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01PB7Sfl2Ao6GySLtPG_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01ZmiYEl2Ao6Gxw2ie4_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01I3vV0A2Ao6GyDkyaB_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01AWiZ9S2Ao6GyfeFPx_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01Ne9dxL2Ao6GyZi0sa_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01wszWUE2Ao6GyG1oWF_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01wjqcdO2Ao6GyffBdP_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01l96CW72Ao6GyZjxRe_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01amjiP42Ao6GySLxZ4_!!2220607898249.jpg\"></div></div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.69c5dd407a85f&p=1965853903&k=i_key&t=1774574912\" style=\"display:none\" />",		"desc_img": [			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01M0ZJI42Ao6GyFzrw2_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01PB7Sfl2Ao6GySLtPG_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01ZmiYEl2Ao6Gxw2ie4_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01I3vV0A2Ao6GyDkyaB_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01AWiZ9S2Ao6GyfeFPx_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01Ne9dxL2Ao6GyZi0sa_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01wszWUE2Ao6GyG1oWF_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01wjqcdO2Ao6GyffBdP_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01l96CW72Ao6GyZjxRe_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01amjiP42Ao6GySLxZ4_!!2220607898249.jpg"
		],		"item_imgs": [
			{				"url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN01uOb1hR2Ao6GxqT1FC_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN0177pAu52Ao6GxifvXE_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i4/2220607898249/O1CN01bGMUEU2Ao6GyWn788_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i2/2220607898249/O1CN01oEqiBo2Ao6GyL0et8_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN01PJGfz92Ao6GyWCLOf_!!2220607898249.jpg"
			}
		],		"item_weight": "",		"item_size": "",		"location": "浙江金华",		"post_fee": null,		"express_fee": null,		"ems_fee": "",		"shipping_to": "",		"has_discount": "false",		"video": {			"url": "https://cloud.video.taobao.com/play/u/2220607898249/p/2/e/6/t/1/555455811151.mp4?appKey=38829"
		},		"is_virtual": "",		"sample_id": "",		"is_promotion": "false",		"props_name": "1627207:42777483765:颜色分类:迷你猫咪异性尺【1套5个】高颜值;1627207:42777483766:颜色分类:迷你猫咪异性尺【2套10个】高颜值;1627207:42777483767:颜色分类:迷你猫咪异性尺【3套15个】高颜值",		"prop_imgs": {			"prop_img": [
				{					"properties": "1627207:42777483765",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01LMiyUP2Ao6GyfYCpP_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483766",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01h7tYXa2Ao6GzSAUgt_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483767",					"url": "http://img.alicdn.com/imgextra/i4/2220607898249/O1CN01sNEVLA2Ao6GtArSJt_!!2220607898249.jpg"
				}
			]
		},		"property_alias": "",		"props": [
			{				"name": "品牌",				"value": "无品牌/无注册商标"
			},
			{				"name": "型号",				"value": "32"
			},
			{				"name": "适用学龄段",				"value": "小学"
			},
			{				"name": "颜色分类",				"value": "迷你猫咪异性尺【1套5个】高颜值,迷你猫咪异性尺【2套10个】高颜值,迷你猫咪异性尺【3套15个】高颜值"
			}
		],		"total_sold": "2",		"skus": {			"sku": [
				{					"price": 3.9,					"total_price": 0,					"orginal_price": 3.9,					"properties": "1627207:42777483765",					"properties_name": "1627207:42777483765:颜色分类:迷你猫咪异性尺【1套5个】高颜值",					"quantity": "200",					"sku_id": 6039400548950
				},
				{					"price": 5.9,					"total_price": 0,					"orginal_price": 5.9,					"properties": "1627207:42777483766",					"properties_name": "1627207:42777483766:颜色分类:迷你猫咪异性尺【2套10个】高颜值",					"quantity": "200",					"sku_id": 6039400548951
				},
				{					"price": 7.9,					"total_price": 0,					"orginal_price": 7.9,					"properties": "1627207:42777483767",					"properties_name": "1627207:42777483767:颜色分类:迷你猫咪异性尺【3套15个】高颜值",					"quantity": "200",					"sku_id": 6039400548952
				}
			]
		},		"seller_id": "2220607898249",		"sales": 2,		"shop_id": "238951494",		"props_list": {			"1627207:42777483765": "颜色分类:迷你猫咪异性尺【1套5个】高颜值",			"1627207:42777483766": "颜色分类:迷你猫咪异性尺【2套10个】高颜值",			"1627207:42777483767": "颜色分类:迷你猫咪异性尺【3套15个】高颜值"
		},		"seller_info": {			"nick": "午后杂物社",			"zhuy": "https://shop238951494.taobao.com/",			"shop_name": "午后杂物社"
		},		"tmall": false,		"error": "",		"warning": "",		"url_log": [],		"fav_count": null,		"fans_count": null,		"freight": null,		"props_imgs": {			"prop_img": [
				{					"properties": "1627207:42777483765",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01LMiyUP2Ao6GyfYCpP_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483766",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01h7tYXa2Ao6GzSAUgt_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483767",					"url": "http://img.alicdn.com/imgextra/i4/2220607898249/O1CN01sNEVLA2Ao6GtArSJt_!!2220607898249.jpg"
				}
			]
		},		"_ddf": "lh",		"promo_type": null,		"props_img": {			"1627207:42777483765": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01LMiyUP2Ao6GyfYCpP_!!2220607898249.jpg",			"1627207:42777483766": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01h7tYXa2Ao6GzSAUgt_!!2220607898249.jpg",			"1627207:42777483767": "http://img.alicdn.com/imgextra/i4/2220607898249/O1CN01sNEVLA2Ao6GtArSJt_!!2220607898249.jpg"
		},		"format_check": "ok",		"shop_item": [],		"relate_items": []
	},

响应参数

名称	类型	必须	示例值	描述
item	item[]	1		宝贝详情数据【部分商品获取不到（药品、五金、天猫国际、百亿补贴类等）】
num_iid	Bigint	1	520813250866	宝贝ID
title	String	1	三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮	宝贝标题
desc_short	String	0		商品简介
promotion_price	Int	0		优惠价
price	Float	1	25.8	价格(当商品价格为0时，当前值为-1)，价格来自于未登入的划线价格，会有个别商品价格无法与页面匹配
total_price	Float	0	0
suggestive_price	Float	0	0
orginal_price	String	0	25.80	原价
nick	String	0	欢乐购客栈	掌柜昵称
num	Int	0	3836	库存(没有精确，是模糊值)
min_num	Int	0	0	最小购买数
detail_url	String	0	http://item.taobao.com/item.htm?id=520813250866	宝贝链接
pic_url	String	1	//gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg	宝贝图片
brand	String	0	三刃木	品牌名称
brandId	Int	0	8879363	品牌ID
rootCatId	Int	0	50013886	顶级分类ID
cid	Int	1	50014822
created_time	String	0
modified_time	String	0
delist_time	String	0
desc	String	0		商品详情【暂时不支持】
desc_img	Mix	0	[]	商品详情图片【暂时不支持】
item_imgs	Mix	0	item_imgs[]	商品图片
location	String	0		发货地
video	video[]	0		商品视频【部分商品获取不到】
is_virtual	String	0
props_name	String	0	1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;	商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。
prop_imgs	prop_imgs[]	0		商品属性图片列表
property_alias	String	0	20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色	销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品属性
total_sold	Int	0
skus	skus[]	0		商品规格信息列表
seller_id	Int	0	2844096782	卖家ID
sales	Int	0	138	销量
shop_id	Int	0	151372205	店铺ID
props_list	Mix	0	{20509:9974422: 尺码:36}	商品属性
seller_info	seller_info[]	1		卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	Mix	0	[]
favcount	Int	0	0
fanscount	Int	0	0
method	String	0	item_tmall:pget_item
promo_type	String	0
props_img	Mix	0	1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg	属性图片
shop_item	Mix	0	[]
relate_items	Mix	0	[]