淘宝商品详情 API获取方式和案例展示-CFANZ编程社区

前往测试接口

onebound.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=678006873127&is_promotion=1

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

请求示例

Curl
PHP
PHPsdk
JAVA
C#
Python

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

响应示例

"item": {
		"num_iid": "678006873127",
		"title": "华硕十二代电脑主机i5 12400F/1660S/3060/1650/2060家用游戏高配型水冷台式电竞直播DIY办公全套组装机整机",
		"desc_short": "",
		"price": "2599",
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "3998.00",
		"nick": "asus华硕圣狮出击专卖店",
		"num": "200",
		"min_num": 0,
		"detail_url": "https://item.taobao.com/item.htm?id=678006873127",
		"pic_url": "//img.alicdn.com/imgextra/i4/2211446975815/O1CN01y97Gkp1spJtgtirNC_!!2211446975815.jpg",
		"brand": "Asus/华硕",
		"brandId": "11656",
		"rootCatId": "50018222",
		"cid": "110308",
		"crumbs": [],
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<p><img src=\"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN015RhTK31spJtTPUHCX_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01BhcKZk1spJtjCvBbu_!!2211446975815.png\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01bgqPBf1spJtdBwnSK_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN01QyPwsK1spJtafoD3l_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01c1PTH01spJtYfGKsc_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN016adEnY1spJtYfFX0a_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01qtLYuS1spJtYl2EZw_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN01lGwbQp1spJte7BK6E_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN011ziFmm1spJtYqXwTv_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01junpBD1spJtfFqv8i_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01LbyJbr1spJte1iQhw_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN01NlLcjS1spJteknhqq_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01mtx9Mv1spJtYES9sA_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN016ROBtF1spJtFRXcPU_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01YD6pDd1spJtfvZHBw_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01lDxS3o1spJtU7bjXx_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01NT84vD1spJtYl2uAy_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01hpm5N21spJtfvZbzC_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01xwST8F1spJtfB3NlO_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01pXstzO1spJtfAIzSl_!!2211446975815.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01nA19Xm1spJtYg4UEL_!!2211446975815.jpg\" align=\"absmiddle\" /></p><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.62f9a5637dc2e&p=1778786523&k=i_key&t=1660527973\" style=\"display:none\" />",
		"desc_img": [
			"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN015RhTK31spJtTPUHCX_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01BhcKZk1spJtjCvBbu_!!2211446975815.png",
			"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01bgqPBf1spJtdBwnSK_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN01QyPwsK1spJtafoD3l_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01c1PTH01spJtYfGKsc_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN016adEnY1spJtYfFX0a_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01qtLYuS1spJtYl2EZw_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN01lGwbQp1spJte7BK6E_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN011ziFmm1spJtYqXwTv_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01junpBD1spJtfFqv8i_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01LbyJbr1spJte1iQhw_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i2/2211446975815/O1CN01NlLcjS1spJteknhqq_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01mtx9Mv1spJtYES9sA_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN016ROBtF1spJtFRXcPU_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01YD6pDd1spJtfvZHBw_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01lDxS3o1spJtU7bjXx_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01NT84vD1spJtYl2uAy_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i1/2211446975815/O1CN01hpm5N21spJtfvZbzC_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01xwST8F1spJtfB3NlO_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i3/2211446975815/O1CN01pXstzO1spJtfAIzSl_!!2211446975815.jpg",
			"http://img.alicdn.com/imgextra/i4/2211446975815/O1CN01nA19Xm1spJtYg4UEL_!!2211446975815.jpg"
		],
		"item_imgs": [
			{
				"url": "//img.alicdn.com/imgextra/i4/2211446975815/O1CN01y97Gkp1spJtgtirNC_!!2211446975815.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i2/2211446975815/O1CN01ByQx2x1spJtV6WeGz_!!2211446975815.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i4/2211446975815/O1CN01T2fozl1spJtWOwO3u_!!2211446975815.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i1/2211446975815/O1CN01uQBOAm1spJtU9cTCZ_!!2211446975815.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i2/2211446975815/O1CN01UqfrrU1spJtYn5S7U_!!2211446975815.jpg"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "湖北武汉",
		"post_fee": 0,
		"express_fee": null,
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "true",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "true",
		"props_name": "20105:103646:内存容量:16GB;20122:48202439:硬盘容量:配置一 i5-10400F/DG1 4G/16G/256G;20122:47102287:硬盘容量:配置二 i5-10400F/1650 4G/16G/256G;20122:47101479:硬盘容量:配置三 i5-10400F/1660S 6G/16G/512G;20122:395038694:硬盘容量:配置四 i5-10400F/2060 6G/16G/512G;20122:502944801:硬盘容量:配置五 i5-12400F/2060 6G/16G/512G;20122:118107:硬盘容量:500GB i5-12400F/3060 12G/16G/500G;20122:25484125:硬盘容量:512GB i5-12490F/3060 12G/16G/500G",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "",
		"props": [
			{
				"name": "品牌",
				"value": "Asus/华硕"
			},
			{
				"name": "内存容量",
				"value": "16GB"
			},
			{
				"name": "硬盘容量",
				"value": "配置一 配置二 配置三 配置四 配置五 500GB 512GB"
			},
			{
				"name": "显存容量",
				"value": "无"
			},
			{
				"name": "主板结构",
				"value": "ATX"
			},
			{
				"name": "光驱类型",
				"value": "无光驱"
			},
			{
				"name": "生产企业",
				"value": "圣狮"
			},
			{
				"name": "电源80 PLUS认证",
				"value": "不支持"
			},
			{
				"name": "显卡系列",
				"value": "集显"
			},
			{
				"name": "散热方式",
				"value": "风冷"
			},
			{
				"name": "硬盘类型",
				"value": "固态硬盘(SSD)"
			},
			{
				"name": "CPU系列",
				"value": "Intel/英特尔酷睿i7"
			},
			{
				"name": "主板芯片组类型",
				"value": "Intel B660"
			},
			{
				"name": "电源功率",
				"value": "650W"
			},
			{
				"name": "CPU型号",
				"value": "i7-12700F"
			},
			{
				"name": "显卡芯片品牌",
				"value": "Intel/英特尔"
			},
			{
				"name": "保修期",
				"value": "36个月"
			}
		],
		"total_sold": "85",
		"skus": {
			"sku": [
				{
					"price": "2599",
					"total_price": 0,
					"orginal_price": "2599",
					"properties": "20105:103646;20122:48202439",
					"properties_name": "20105:103646:内存容量:16GB;20122:48202439:硬盘容量:配置一 i5-10400F/DG1 4G/16G/256G",
					"quantity": "159",
					"sku_id": "5049697202517"
				},
				{
					"price": "3399",
					"total_price": 0,
					"orginal_price": "3399",
					"properties": "20105:103646;20122:47102287",
					"properties_name": "20105:103646:内存容量:16GB;20122:47102287:硬盘容量:配置二 i5-10400F/1650 4G/16G/256G",
					"quantity": "94",
					"sku_id": "5049697202516"
				},
				{
					"price": "3999",
					"total_price": 0,
					"orginal_price": "3999",
					"properties": "20105:103646;20122:47101479",
					"properties_name": "20105:103646:内存容量:16GB;20122:47101479:硬盘容量:配置三 i5-10400F/1660S 6G/16G/512G",
					"quantity": "99",
					"sku_id": "5049697202515"
				},
				{
					"price": "4499",
					"total_price": 0,
					"orginal_price": "4499",
					"properties": "20105:103646;20122:395038694",
					"properties_name": "20105:103646:内存容量:16GB;20122:395038694:硬盘容量:配置四 i5-10400F/2060 6G/16G/512G",
					"quantity": "97",
					"sku_id": "5049697202514"
				},
				{
					"price": "5099",
					"total_price": 0,
					"orginal_price": "5099",
					"properties": "20105:103646;20122:502944801",
					"properties_name": "20105:103646:内存容量:16GB;20122:502944801:硬盘容量:配置五 i5-12400F/2060 6G/16G/512G",
					"quantity": "98",
					"sku_id": "5049697202518"
				},
				{
					"price": "5499",
					"total_price": 0,
					"orginal_price": "5499",
					"properties": "20105:103646;20122:118107",
					"properties_name": "20105:103646:内存容量:16GB;20122:118107:硬盘容量:500GB i5-12400F/3060 12G/16G/500G",
					"quantity": "100",
					"sku_id": "5049697202512"
				},
				{
					"price": "5999",
					"total_price": 0,
					"orginal_price": "5999",
					"properties": "20105:103646;20122:25484125",
					"properties_name": "20105:103646:内存容量:16GB;20122:25484125:硬盘容量:512GB i5-12490F/3060 12G/16G/500G",
					"quantity": "100",
					"sku_id": "5049697202513"
				}
			]
		},
		"seller_id": "2211446975815",
		"sales": 200,
		"shop_id": "242066445",
		"props_list": {
			"20105:103646": "内存容量:16GB",
			"20122:48202439": "硬盘容量:配置一 i5-10400F/DG1 4G/16G/256G",
			"20122:47102287": "硬盘容量:配置二 i5-10400F/1650 4G/16G/256G",
			"20122:47101479": "硬盘容量:配置三 i5-10400F/1660S 6G/16G/512G",
			"20122:395038694": "硬盘容量:配置四 i5-10400F/2060 6G/16G/512G",
			"20122:502944801": "硬盘容量:配置五 i5-12400F/2060 6G/16G/512G",
			"20122:118107": "硬盘容量:500GB i5-12400F/3060 12G/16G/500G",
			"20122:25484125": "硬盘容量:512GB i5-12490F/3060 12G/16G/500G"
		},
		"seller_info": {
			"nick": "asus华硕圣狮出击专卖店",
			"item_score": "4.9 ",
			"score_p": "4.9 ",
			"delivery_score": "4.9 ",
			"shop_type": "B",
			"user_num_id": "2211446975815",
			"sid": "242066445",
			"title": "asus华硕圣狮出击专卖店",
			"zhuy": "https://shop242066445.taobao.com/",
			"shop_name": "asus华硕圣狮出击专卖店"
		},
		"tmall": true,
		"error": "",
		"warning": "",
		"url_log": [],
		"fav_count": "642",
		"fans_count": "1.8万",
		"freight": "快递: 免运费",
		"props_imgs": {
			"prop_img": []
		},
		"_ddf": "xdl",
		"promo_type": null,
		"props_img": [],
		"format_check": "ok",
		"shop_item": [],
		"relate_items": []
	},
	"error": "",
	"secache": "bd252d43be53cb8c30044bb810ae6a8a",
	"secache_time": 1660527973,
	"secache_date": "2022-08-15 09:46:13",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:127 max:10100 all[149=127+7+15];expires:2030-12-31",
	"execution_time": "1.995",
	"server_time": "Beijing/2022-08-15 09:46:13",
	"client_ip": "106.6.32.219",
	"call_args": {
		"num_iid": "678006873127",
		"is_promotion": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_new",
	"server_memory": "5.94MB",
	"request_id": "gw-1.62f9a5637dc2e",
	"last_id": "1151581840"
}