淘宝商品属性sku信息价格主图详情图片，一个API搞定

admin2个月前 (05-14)淘宝API112

引言

淘宝商品详情接口是淘宝的核心数据接口，可通过商品 ID 获取标题、价格、SKU 规格、props_name属性、库存、图文详情、店铺信息等标准化结构化数据。该接口主要用于ERP 进销存同步、多平台铺货搬家、竞品价格监控、比价导购、跨境反向海淘、电商数据分析等场景，为电商系统开发、自动化运营、选品分析提供稳定合规的数据支撑。

API名：淘宝item_get/item_get_pro

taobao.item_get 测试入口

公共参数

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

请求参数

请求参数：num_iid=652874751412&is_promotion=1

参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价

响应参数

名称	类型	必须	示例值	描述
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	[]

API测试实例

商品详情页面

编辑

响应示例

"item": {		"num_iid": "899330283965",		"title": "2025新款睡衣女夏季短袖长裤两件套莫代尔薄款大尺码开衫家居服套装",		"desc_short": "",		"price": "75.00",		"total_price": 0,		"suggestive_price": 0,		"orginal_price": "75.00",		"nick": "至臻尚品坊",		"num": 432,		"min_num": 0,		"detail_url": "https://item.taobao.com/item.htm?id=899330283965",		"pic_url": "//img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg",		"brand": "无品牌/无注册商标",		"brandId": null,		"rootCatId": null,		"cid": "50012772",		"crumbs": [],		"created_time": "",		"modified_time": "",		"delist_time": "",		"desc": "<img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i3/475611098/O1CN01bIcBq61JyvvDFzyDJ_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i1/475611098/O1CN01Y51NOP1JyvvEZGmO6_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i3/475611098/O1CN01GE2ElA1JyvvEZHFUb_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i3/475611098/O1CN01o7WvWI1JyvvCnVCh7_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i3/475611098/O1CN01pa5Ckx1JyvvEyO6JV_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i4/475611098/O1CN01Oe56aK1JyvvDG0hyo_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i3/475611098/O1CN01BhXyXg1Jyvv6PuqC9_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i1/475611098/O1CN01LTQq991JyvvDcvA6z_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i2/475611098/O1CN01Huaz9a1JyvvCdGaeN_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i3/475611098/O1CN01QYIrbu1JyvvDG2zOZ_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i4/475611098/O1CN017zSSvG1JyvvAgwec8_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i2/475611098/O1CN014Q1NUv1JyvvE29OvS_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i2/475611098/O1CN018o8ofV1JyvvAgwzPa_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i2/475611098/O1CN01J07f9S1JyvvEZHv5m_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i2/475611098/O1CN01lX9wAO1JyvvDCiN9k_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i1/475611098/O1CN01tr9BF21JyvvCdJk4x_!!475611098.png\" ><img align =\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i4/475611098/O1CN01kXcJri1JyvvAgvJUL_!!475611098.png\" ><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.6a0534a3054d5&p=1965854574&k=i_key&t=1778726051\" style=\"display:none\" />",		"desc_img": [			"https://img.alicdn.com/imgextra/i3/475611098/O1CN01bIcBq61JyvvDFzyDJ_!!475611098.png",			"https://img.alicdn.com/imgextra/i1/475611098/O1CN01Y51NOP1JyvvEZGmO6_!!475611098.png",			"https://img.alicdn.com/imgextra/i3/475611098/O1CN01GE2ElA1JyvvEZHFUb_!!475611098.png",			"https://img.alicdn.com/imgextra/i3/475611098/O1CN01o7WvWI1JyvvCnVCh7_!!475611098.png",			"https://img.alicdn.com/imgextra/i3/475611098/O1CN01pa5Ckx1JyvvEyO6JV_!!475611098.png",			"https://img.alicdn.com/imgextra/i4/475611098/O1CN01Oe56aK1JyvvDG0hyo_!!475611098.png",			"https://img.alicdn.com/imgextra/i3/475611098/O1CN01BhXyXg1Jyvv6PuqC9_!!475611098.png",			"https://img.alicdn.com/imgextra/i1/475611098/O1CN01LTQq991JyvvDcvA6z_!!475611098.png",			"https://img.alicdn.com/imgextra/i2/475611098/O1CN01Huaz9a1JyvvCdGaeN_!!475611098.png",			"https://img.alicdn.com/imgextra/i3/475611098/O1CN01QYIrbu1JyvvDG2zOZ_!!475611098.png",			"https://img.alicdn.com/imgextra/i4/475611098/O1CN017zSSvG1JyvvAgwec8_!!475611098.png",			"https://img.alicdn.com/imgextra/i2/475611098/O1CN014Q1NUv1JyvvE29OvS_!!475611098.png",			"https://img.alicdn.com/imgextra/i2/475611098/O1CN018o8ofV1JyvvAgwzPa_!!475611098.png",			"https://img.alicdn.com/imgextra/i2/475611098/O1CN01J07f9S1JyvvEZHv5m_!!475611098.png",			"https://img.alicdn.com/imgextra/i2/475611098/O1CN01lX9wAO1JyvvDCiN9k_!!475611098.png",			"https://img.alicdn.com/imgextra/i1/475611098/O1CN01tr9BF21JyvvCdJk4x_!!475611098.png",			"https://img.alicdn.com/imgextra/i4/475611098/O1CN01kXcJri1JyvvAgvJUL_!!475611098.png"
		],		"item_imgs": [
			{				"url": "//img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i4/475611098/O1CN01Kzwas91JyvvBSggVb_!!475611098.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i4/475611098/O1CN01hIOIoL1JyvvE564nX_!!475611098.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i1/475611098/O1CN01TUnbqd1JyvvE550Gh_!!475611098.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/475611098/p/2/e/6/t/1/512163578977.mp4?appKey=38829"
		},		"is_virtual": "",		"sample_id": "",		"is_promotion": "false",		"props_name": "20509:28314:尺码:S 体重115以内;20509:28315:尺码:M 体重115-135;20509:28316:尺码:L 体重135-155;1627207:28334:颜色分类:灰色;1627207:39931775:颜色分类:豆沙粉",		"prop_imgs": {			"prop_img": [
				{					"properties": "1627207:28334",					"url": "https://img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg"
				},
				{					"properties": "1627207:39931775",					"url": "https://img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg"
				}
			]
		},		"property_alias": "",		"props": [
			{				"name": "品牌",				"value": "无品牌/无注册商标"
			},
			{				"name": "风格",				"value": "简约风"
			},
			{				"name": "上市年份季节",				"value": "2025年夏季"
			},
			{				"name": "裤长",				"value": "长裤"
			},
			{				"name": "面料",				"value": "莫代尔"
			},
			{				"name": "适用人群",				"value": "青年"
			},
			{				"name": "裤门襟",				"value": "皮筋"
			},
			{				"name": "适用场景",				"value": "休闲"
			},
			{				"name": "适用季节",				"value": "夏季"
			},
			{				"name": "厚薄",				"value": "薄款"
			},
			{				"name": "袖长",				"value": "短袖"
			},
			{				"name": "裙长",				"value": "长裙"
			},
			{				"name": "领型",				"value": "小翻领"
			},
			{				"name": "图案",				"value": "纯色"
			},
			{				"name": "适用性别",				"value": "女"
			},
			{				"name": "尺码",				"value": "S,M,L"
			},
			{				"name": "颜色分类",				"value": "灰色,豆沙粉"
			}
		],		"total_sold": "9",		"skus": {			"sku": [
				{					"price": 75,					"total_price": 0,					"orginal_price": 75,					"properties": "20509:28314;1627207:28334",					"properties_name": "20509:28314:尺码:S 体重115以内;1627207:28334:颜色分类:灰色",					"quantity": 58,					"sku_id": "5923187631738"
				},
				{					"price": 75,					"total_price": 0,					"orginal_price": 75,					"properties": "20509:28315;1627207:28334",					"properties_name": "20509:28315:尺码:M 体重115-135;1627207:28334:颜色分类:灰色",					"quantity": 62,					"sku_id": "5923187631739"
				},
				{					"price": 75,					"total_price": 0,					"orginal_price": 75,					"properties": "20509:28316;1627207:28334",					"properties_name": "20509:28316:尺码:L 体重135-155;1627207:28334:颜色分类:灰色",					"quantity": 75,					"sku_id": "5923187631740"
				},
				{					"price": 75,					"total_price": 0,					"orginal_price": 75,					"properties": "20509:28314;1627207:39931775",					"properties_name": "20509:28314:尺码:S 体重115以内;1627207:39931775:颜色分类:豆沙粉",					"quantity": 82,					"sku_id": "5923187631741"
				},
				{					"price": 75,					"total_price": 0,					"orginal_price": 75,					"properties": "20509:28315;1627207:39931775",					"properties_name": "20509:28315:尺码:M 体重115-135;1627207:39931775:颜色分类:豆沙粉",					"quantity": 74,					"sku_id": "5923187631742"
				},
				{					"price": 75,					"total_price": 0,					"orginal_price": 75,					"properties": "20509:28316;1627207:39931775",					"properties_name": "20509:28316:尺码:L 体重135-155;1627207:39931775:颜色分类:豆沙粉",					"quantity": 81,					"sku_id": "5923187631743"
				}
			]
		},		"seller_id": "475611098",		"sales": 9,		"shop_id": "104010583",		"props_list": {			"20509:28314": "尺码:S 体重115以内",			"20509:28315": "尺码:M 体重115-135",			"20509:28316": "尺码:L 体重135-155",			"1627207:28334": "颜色分类:灰色",			"1627207:39931775": "颜色分类:豆沙粉"
		},		"seller_info": {			"nick": "至臻尚品坊",			"item_score": "4.9 ",			"score_p": "4.9 ",			"delivery_score": "4.8 ",			"zhuy": "https://shop104010583.taobao.com/",			"shop_name": "至臻尚品坊"
		},		"tmall": false,		"error": "",		"warning": "",		"url_log": [],		"fav_count": null,		"fans_count": null,		"freight": null,		"props_imgs": {			"prop_img": [
				{					"properties": "1627207:28334",					"url": "https://img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg"
				},
				{					"properties": "1627207:39931775",					"url": "https://img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg"
				}
			]
		},		"_ddf": "ykn",		"promo_type": null,		"props_img": {			"1627207:28334": "https://img.alicdn.com/imgextra/i2/475611098/O1CN01rak0Wv1JyvvDQsMe8_!!475611098.jpg",			"1627207:39931775": "https://img.alicdn.com/imgextra/i2/475611098/O1CN01kd7uwK1JyvvAghovR_!!475611098.jpg"
		},		"format_check": "ok",		"shop_item": [],		"relate_items": []
	},

返回列表

上一篇：获取淘宝商品列表的几个API介绍

下一篇：京东商品主图 & 详情图 API 接口实战开发｜电商图片数据合规获取方案