万邦api博客

获取淘宝商品详情API响应数据解析参数说明（价格、商品标题、商品url，主图、详情等）

admin3周前淘宝API35

获取淘宝商品详情API是常用的电商平台接口，应用场景主要包括商家店铺商品管理、第三方电商运营工具开发、商品比价与导购平台搭建、电商市场数据分析调研、商品库存与价格实时监控、跨平台商品信息同步这几类。

下面是一个调用实例，响应数据如下：

"item": {		"num_iid": "652874751412",		"title": "奶油风布艺沙发现代简约轻奢小户型客厅直排可拆洗沙发原木可定制",		"desc_short": "",		"price": "480.00",		"total_price": 0,		"suggestive_price": 0,		"orginal_price": "480.00",		"nick": "佑安居",		"num": 1513,		"min_num": 0,		"detail_url": "https://item.taobao.com/item.htm?id=652874751412",		"pic_url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN01aYBriY1Jem9UDtt9e_!!2568161054.jpg",		"brand": "#0 工厂",		"brandId": null,		"rootCatId": null,		"cid": "50020632",		"crumbs": [],		"created_time": "",		"modified_time": "",		"delist_time": "",		"desc": "<div style=\"width: 750.0px;height: 10575.0px;overflow: hidden;\">\n<div style=\"width: 750.0px;height: 10575.0px;overflow: hidden;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN01LFmSOU1Jem9QOjMPb_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN014vyOOT1Jem9DpHz3Y_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01B3PpsA1Jem9N8V7uf_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN015JbyeY1Jem9MZshUt_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HXSoxx1Jem9RvgzHN_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN01IEultA1Jem9MdEx8R_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN0176K98O1Jem9QOjE69_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN013Pxp1O1Jem9RvgeTv_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01SfyZ8M1Jem9QOi1Gx_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01bb1POa1Jem9Sdgve2_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i3/2568161054/O1CN018Eo9dV1Jem9KV0y79_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01vuEofr1Jem9Nzy9xY_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01qw9sAi1Jem8wkNKpy_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HeFhFw1Jem8rLnjBY_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01SNgjoi1Jem9QOil15_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01RXf3RA1Jem9DpHVwj_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01gZmZjt1Jem9ISThgm_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01YL0FHM1Jem9PQTjX9_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"><img src=\"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01UhsEhZ1Jem8yvJIhZ_!!2568161054.jpg\" style=\"display: block;width: 100.0%;\"></div>\n</div>",		"desc_img": [			"https://img.alicdn.com/imgextra/i3/2568161054/O1CN01LFmSOU1Jem9QOjMPb_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i3/2568161054/O1CN014vyOOT1Jem9DpHz3Y_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01B3PpsA1Jem9N8V7uf_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i2/2568161054/O1CN015JbyeY1Jem9MZshUt_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HXSoxx1Jem9RvgzHN_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i3/2568161054/O1CN01IEultA1Jem9MdEx8R_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i3/2568161054/O1CN0176K98O1Jem9QOjE69_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i4/2568161054/O1CN013Pxp1O1Jem9RvgeTv_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01SfyZ8M1Jem9QOi1Gx_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01bb1POa1Jem9Sdgve2_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i3/2568161054/O1CN018Eo9dV1Jem9KV0y79_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01vuEofr1Jem9Nzy9xY_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01qw9sAi1Jem8wkNKpy_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HeFhFw1Jem8rLnjBY_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01SNgjoi1Jem9QOil15_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01RXf3RA1Jem9DpHVwj_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01gZmZjt1Jem9ISThgm_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i2/2568161054/O1CN01YL0FHM1Jem9PQTjX9_!!2568161054.jpg",			"https://img.alicdn.com/imgextra/i4/2568161054/O1CN01UhsEhZ1Jem8yvJIhZ_!!2568161054.jpg"
		],		"item_imgs": [
			{				"url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN01aYBriY1Jem9UDtt9e_!!2568161054.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i3/2568161054/O1CN01kjOfNb1Jem9DmWn8Y_!!2568161054.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i1/2568161054/O1CN01HoB9ha1Jem9DmWn8r_!!2568161054.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN011PjP2P1Jem9MXEUFT_!!2568161054.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i3/2568161054/O1CN01KUfBFL1Jem9KTTMn1_!!2568161054.jpg"
			}
		],		"item_weight": "",		"item_size": "",		"location": "江苏南通",		"post_fee": null,		"express_fee": null,		"ems_fee": "",		"shipping_to": "",		"has_discount": "",		"video": {			"url": ""
		},		"is_virtual": "",		"sample_id": "",		"is_promotion": "",		"props_name": "31480:14306495906:几人坐:脚踏90*60*48cm;31480:14306495907:几人坐:双人165*95*67cm;31480:14306495908:几人坐:三人210*95*67cm;31480:14306495909:几人坐:单人100*95*67cm;31480:21480914361:几人坐:四人位240*95*67cm;31480:21480914362:几人坐:大四人320*95*76cm;31480:1387571900:几人坐:3米贵妃沙发;31480:32527954:几人坐:定制尺寸;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",		"prop_imgs": {			"prop_img": [
				{					"properties": "1627207:28321",					"url": "http://img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
				}
			]
		},		"property_alias": "",		"props": [
			{				"name": "品牌",				"value": "#0 工厂"
			},
			{				"name": "型号",				"value": "520"
			},
			{				"name": "材质",				"value": "木"
			},
			{				"name": "木质材质",				"value": "松木"
			},
			{				"name": "面料",				"value": "绒布"
			},
			{				"name": "风格",				"value": "北欧"
			},
			{				"name": "几人坐",				"value": "脚踏90*60*48cm,双人165*95*67cm,三人210*95*67cm,单人100*95*67cm,四人位240*95*67cm,大四人320*95*76cm,3米贵妃沙发,定制尺寸"
			},
			{				"name": "颜色分类",				"value": "乳白色"
			},
			{				"name": "填充物",				"value": "海绵"
			},
			{				"name": "结构工艺",				"value": "木质工艺"
			},
			{				"name": "是否可定制",				"value": "是"
			},
			{				"name": "沙发组合形式",				"value": "U形"
			},
			{				"name": "是否可拆洗",				"value": "是"
			},
			{				"name": "适用对象",				"value": "成年人"
			},
			{				"name": "是否带储物空间",				"value": "否"
			},
			{				"name": "产地",				"value": "上海"
			},
			{				"name": "地市",				"value": "上海市"
			},
			{				"name": "区县",				"value": "奉贤区"
			},
			{				"name": "是否组装",				"value": "否"
			},
			{				"name": "出租车是否可运输",				"value": "否"
			},
			{				"name": "坐垫硬度等级",				"value": "软"
			},
			{				"name": "款式定位",				"value": "经济型"
			}
		],		"total_sold": "1",		"skus": {			"sku": [
				{					"price": 3000,					"total_price": 0,					"orginal_price": 3000,					"properties": "31480:32527954;1627207:28321",					"properties_name": "31480:32527954:几人坐:定制尺寸;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "200",					"sku_id": 5039985183003
				},
				{					"price": 968,					"total_price": 0,					"orginal_price": 968,					"properties": "31480:14306495909;1627207:28321",					"properties_name": "31480:14306495909:几人坐:单人100*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "200",					"sku_id": 4881047531346
				},
				{					"price": 2388,					"total_price": 0,					"orginal_price": 2388,					"properties": "31480:21480914361;1627207:28321",					"properties_name": "31480:21480914361:几人坐:四人位240*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "200",					"sku_id": 5039985183001
				},
				{					"price": 3188,					"total_price": 0,					"orginal_price": 3188,					"properties": "31480:21480914362;1627207:28321",					"properties_name": "31480:21480914362:几人坐:大四人320*95*76cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "200",					"sku_id": 5039985183002
				},
				{					"price": 1688,					"total_price": 0,					"orginal_price": 1688,					"properties": "31480:14306495907;1627207:28321",					"properties_name": "31480:14306495907:几人坐:双人165*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "129",					"sku_id": 4881047531344
				},
				{					"price": 2088,					"total_price": 0,					"orginal_price": 2088,					"properties": "31480:14306495908;1627207:28321",					"properties_name": "31480:14306495908:几人坐:三人210*95*67cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "184",					"sku_id": 4881047531345
				},
				{					"price": 480,					"total_price": 0,					"orginal_price": 480,					"properties": "31480:14306495906;1627207:28321",					"properties_name": "31480:14306495906:几人坐:脚踏90*60*48cm;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "200",					"sku_id": 4881047531343
				},
				{					"price": 3400,					"total_price": 0,					"orginal_price": 3400,					"properties": "31480:1387571900;1627207:28321",					"properties_name": "31480:1387571900:几人坐:3米贵妃沙发;1627207:28321:颜色分类:乳白色 尺寸颜色可定制",					"quantity": "200",					"sku_id": 5039984824000
				}
			]
		},		"seller_id": "2568161054",		"sales": 1,		"shop_id": "567158267",		"props_list": {			"31480:14306495906": "几人坐:脚踏90*60*48cm",			"31480:14306495907": "几人坐:双人165*95*67cm",			"31480:14306495908": "几人坐:三人210*95*67cm",			"31480:14306495909": "几人坐:单人100*95*67cm",			"31480:21480914361": "几人坐:四人位240*95*67cm",			"31480:21480914362": "几人坐:大四人320*95*76cm",			"31480:1387571900": "几人坐:3米贵妃沙发",			"31480:32527954": "几人坐:定制尺寸",			"1627207:28321": "颜色分类:乳白色 尺寸颜色可定制"
		},		"seller_info": {			"nick": "佑安居",			"zhuy": "https://shop567158267.taobao.com/",			"shop_name": "佑安居"
		},		"tmall": false,		"error": "",		"warning": "",		"url_log": [],		"fav_count": null,		"fans_count": null,		"freight": null,		"props_imgs": {			"prop_img": [
				{					"properties": "1627207:28321",					"url": "http://img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
				}
			]
		},		"_ddf": "lh",		"props_img": {			"1627207:28321": "http://img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
		}
	},	"secache": "b33991a591383282e2a0685e02db4e2b",	"secache_time": 1760941933,	"secache_date": "2025-10-20 14:32:13",	"translate_status": "",	"translate_time": 0,	"language": {		"default_lang": "cn",		"current_lang": "cn"
	},

num_iid：商品id（唯一标识）

title：商品标题

price：商品价格

nick：店铺昵称

detail_url：商品链接

pic_ur：商品主图

brand：品牌

cid：商品类目id

desc：商品详情

desc_img：详情图

item_imgs：商品主图

location：生产地

props_name：商品sku

props：商品属性

skus：商品sku

seller_info：店铺信息

API请求示例

curl

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

注意事项

1. 权限与认证

  • 必须先完成淘宝开放平台的开发者认证，申请对应 API 的调用权限，获取合法的appkey和appsecret。

  • 调用时需按规范生成签名，确保请求身份合法，未通过认证或签名错误会直接被拒绝。

2. 调用频率与流量控制

  • 严格遵守平台设定的调用频率限制（如单账号每秒调用次数），超出限制会触发限流，导致短期无法调用。

  • 高并发场景需提前申请扩容，避免因流量峰值触发平台风控。

3. 参数规范

  • 需传入正确的必填参数（如商品 IDitem_id），参数格式、数据类型需符合 API 文档要求，缺失或错误会返回参数异常。

  • 非必填参数按需传递，避免传入无效或违规参数，增加请求失败概率。

4. 数据使用合规

  • 调用获取的商品数据仅可用于申请时报备的场景，不可用于倒卖、恶意爬取或侵犯商家 / 平台权益的用途。

  • 需遵守淘宝平台的数据安全规定，不泄露、不篡改获取的商品信息。

5. 错误处理与重试

  • 需提前适配常见错误码（如权限不足、商品不存在），避免直接抛出异常影响业务。

  • 重试机制需合理设置间隔（如 1-3 秒），避免频繁重试加重平台负担，触发更严格的限制。

6. 版本兼容性

  • 关注 API 版本更新通知，旧版本可能会被逐步停用，需及时升级至最新稳定版本，避免因版本淘汰导致调用失效。









返回列表

上一篇：3 步实现电商平台订单自动同步，API 接口实操教程

下一篇：淘宝商品视频获取方案|调用API抓取商品视频详细步骤

相关文章

淘宝商品详情 API 接口 item_get：高效获取商品数据的技术方案

淘宝商品详情 API 接口 item_get：高效获取商品数据的技术方案

 编辑在电商数据开发、比价系统搭建、竞品分析工具开发等场景中，IT 技术员常面临 “如何稳定、合规地获取淘宝商品详情数据” 的难题 —— 传统爬虫不仅易触发反爬机制导致 IP 封禁，还需频繁...

淘宝商品详情数据获取技术方案全解析

淘宝商品详情数据获取技术方案全解析

在电商运营、市场调研、竞品分析等场景中，淘宝商品详情数据（如价格、销量、评价、规格参数等）具有极高的应用价值。但淘宝平台存在严格的反爬机制与数据权限管控，直接获取数据需遵循合规路径并采用专业技术方案。...

欢迎来到我的博客~

欢迎来到我的博客~...

淘宝评论接口技术解析：原理、实现与合规实践

淘宝评论接口技术解析：原理、实现与合规实践

 编辑淘宝评论接口item_review一、接口基础架构：开放与内部的双重体系淘宝评论数据的接口体系分为开放平台正规接口与内部业务接口两大类别，二者在访问权限、应用场景与技术规范上存在本质差...

淘宝商品详情图片爬取API：item_get_desc调用实例

淘宝商品详情图片爬取API：item_get_desc调用实例

 淘宝商品详情一般是以图片的形式列出来的。想要获取商品的详情信息，就要拿到这些图片。像网店搬家，无货源电商都需要批量自动化拿这些商品详情数据。前段时间给客户封装了一个API，用来获取淘宝的商...

淘宝商品视频批量自动化获取的常见渠道分享

淘宝商品视频批量自动化获取的常见渠道分享

 编辑返回以上json数据在电商数字化运营中，商品视频作为重要的内容资产，其批量获取与分析已成为竞品监测、内容优化的关键环节。本文将系统梳理淘宝商品视频批量自动化获取的合法渠道，深入解析技术...

发表评论    

◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。

Copyright Your WebSite.Some Rights Reserved.

Powered By Z-BlogPHP. Theme by TOYEAN.