API接口名称（item_get - 获得淘宝商品详情）[item_search,item_get,item_search_shop等]

公共参数

请求地址: api-gw.onebound.cn/taobao/item…

名称	类型	必须	描述
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=520813250866&is_promotion=1

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

API测试工具 点击申请试用

响应参数

Version: Date:2022-04-04

名称	类型	必须	示例值	描述
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	价格
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	item.taobao.com/item.htm?id…	宝贝链接
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
crumbs	Mix	0	[]	导航菜单
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[]	商品图片
item_weight	String	0
item_size	String	0
location	String	0		发货地
express_fee	Float	0	0.00	快递费用
ems_fee	Float	0		EMS费用
post_fee	Float	0		物流费用
shipping_to	String	0		发货至
has_discount	Boolean	0	false	是否有优惠
video	video[]	0		商品视频
is_virtual	String	0
sample_id	String	0		商品风格标识ID
is_promotion	Boolean	0	false	是否促销
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	[]

请求示例

• PHP

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=520813250866&is_promotion=1";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

API 返回结果

---------------------------------------
{
	"item": {
		"num_iid": "670709161783",
		"title": "IFIK Ripped Shorts 'Railway叛逆街头翻边破坏高腰热裤牛仔短裤",
		"desc_short": "",
		"price": "330",
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "330.00",
		"nick": "ifiker",
		"num": "79",
		"min_num": 0,
		"detail_url": "https://item.taobao.com/item.htm?id=670709161783",
		"pic_url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN010gD5oa1nzKUAQAPOM_!!2209411885160-0-picasso.jpg",
		"brand": "iFIK",
		"brandId": "1584893553",
		"rootCatId": "16",
		"cid": "162205",
		"crumbs": [],
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<div >\n   <div >\n    <img  src=\"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01hQudIh1nzKTpaopiS_!!2209411885160.jpg\" />\n    <img usemap=\"#customizeHyperlinks-2\"  src=\"http://gtms01.alicdn.com/tps/i1/TB1AHXiGXXXXXXAXVXX.uTD.FXX-10-10.png\" />\n    <map name=\"customizeHyperlinks-2\"></map>\n    <img  src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01WN30RQ1nzKThc66qE_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01nYVENA1nzKThUST9G_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01FLLMIN1nzKTeT9csi_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01hFk3sY1nzKTmk0qit_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01IluNP11nzKTod0Wmo_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i1/2209411885160/O1CN015e9eo71nzKTnqrSZy_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i1/2209411885160/O1CN01fN3X0x1nzKToczWPE_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i1/2209411885160/O1CN01NkDyD11nzKTod3HFU_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01qjtSEf1nzKTjF22sT_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01tL969M1nzKT3TKGe2_!!2209411885160.jpg\" />\n    <img  src=\"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01y3N2171nzKT2OjdGT_!!2209411885160.jpg\" />\n   </div>\n  </div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.634666f468ea8&p=1778787724&k=i_key&t=1665558261\" style=\"display:none\" />",
		"desc_img": [
			"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01hQudIh1nzKTpaopiS_!!2209411885160.jpg",
			"http://gtms01.alicdn.com/tps/i1/TB1AHXiGXXXXXXAXVXX.uTD.FXX-10-10.png",
			"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01WN30RQ1nzKThc66qE_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i2/2209411885160/O1CN01nYVENA1nzKThUST9G_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01FLLMIN1nzKTeT9csi_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01hFk3sY1nzKTmk0qit_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01IluNP11nzKTod0Wmo_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i1/2209411885160/O1CN015e9eo71nzKTnqrSZy_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i1/2209411885160/O1CN01fN3X0x1nzKToczWPE_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i1/2209411885160/O1CN01NkDyD11nzKTod3HFU_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01qjtSEf1nzKTjF22sT_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i4/2209411885160/O1CN01tL969M1nzKT3TKGe2_!!2209411885160.jpg",
			"http://img.alicdn.com/imgextra/i3/2209411885160/O1CN01y3N2171nzKT2OjdGT_!!2209411885160.jpg"
		],
		"item_imgs": [
			{
				"url": "//img.alicdn.com/imgextra/i1/2209411885160/O1CN010gD5oa1nzKUAQAPOM_!!2209411885160-0-picasso.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i3/2209411885160/O1CN01TngIaS1nzKSepiTBF_!!2209411885160.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i3/2209411885160/O1CN01pqdPsZ1nzKST57eK9_!!2209411885160.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i3/2209411885160/O1CN01Nw34rB1nzKSZpGHq7_!!2209411885160.jpg"
			},
			{
				"url": "//img.alicdn.com/imgextra/i2/2209411885160/O1CN015s6nzO1nzKSrFefnZ_!!2209411885160.jpg"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "广东广州",
		"post_fee": 0,
		"express_fee": null,
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "false",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "false",
		"props_name": "20518:1129774872:尺寸:I1(S);20518:12815520791:尺寸:I2(M);20518:12815520792:尺寸:I3(L);1627207:34664008:颜色分类:水洗蓝 现货",
		"prop_imgs": {
			"prop_img": [
				{
					"properties": "1627207:34664008",
					"url": "//img.alicdn.com/imgextra/i3/2209411885160/O1CN01gixXjQ1nzKRzXyMZz_!!2209411885160.jpg"
				}
			]
		},
		"property_alias": "",
		"props": [
			{
				"name": "品牌",
				"value": "iFIK"
			},
			{
				"name": "适用年龄",
				"value": "18-24周岁"
			},
			{
				"name": "尺寸",
				"value": "I1(S),I2(M),I3(L)"
			},
			{
				"name": "面料分类",
				"value": "其他"
			},
			{
				"name": "腰型",
				"value": "高腰"
			},
			{
				"name": "工艺",
				"value": "磨破"
			},
			{
				"name": "颜色分类",
				"value": "水洗蓝"
			},
			{
				"name": "裤门襟",
				"value": "拉链"
			},
			{
				"name": "成分含量",
				"value": "96%及以上"
			},
			{
				"name": "年份季节",
				"value": "2022年夏季"
			},
			{
				"name": "厚薄",
				"value": "常规"
			},
			{
				"name": "裤长",
				"value": "短裤"
			},
			{
				"name": "颜色",
				"value": "浅色"
			}
		],
		"total_sold": "428",
		"skus": {
			"sku": [
				{
					"price": "330",
					"total_price": 0,
					"orginal_price": "330",
					"properties": "20518:1129774872;1627207:34664008",
					"properties_name": "20518:1129774872:尺寸:I1(S);1627207:34664008:颜色分类:水洗蓝 现货",
					"quantity": "2",
					"sku_id": "4997947702513"
				},
				{
					"price": "330",
					"total_price": 0,
					"orginal_price": "330",
					"properties": "20518:12815520791;1627207:34664008",
					"properties_name": "20518:12815520791:尺寸:I2(M);1627207:34664008:颜色分类:水洗蓝 现货",
					"quantity": "24",
					"sku_id": "4997947702514"
				},
				{
					"price": "330",
					"total_price": 0,
					"orginal_price": "330",
					"properties": "20518:12815520792;1627207:34664008",
					"properties_name": "20518:12815520792:尺寸:I3(L);1627207:34664008:颜色分类:水洗蓝 现货",
					"quantity": "53",
					"sku_id": "4997947702515"
				}
			]
		},
		"seller_id": "2209411885160",
		"sales": 31,
		"shop_id": "433655136",
		"props_list": {
			"20518:1129774872": "尺寸:I1(S)",
			"20518:12815520791": "尺寸:I2(M)",
			"20518:12815520792": "尺寸:I3(L)",
			"1627207:34664008": "颜色分类:水洗蓝 现货"
		},
		"seller_info": {
			"nick": "ifiker",
			"item_score": "4.8 ",
			"score_p": "4.9 ",
			"delivery_score": "4.9 ",
			"shop_type": "C",
			"user_num_id": "2209411885160",
			"sid": "433655136",
			"title": "IFIK",
			"zhuy": "https://shop433655136.taobao.com/",
			"shop_name": "IFIK"
		},
		"tmall": false,
		"error": "",
		"warning": "",
		"url_log": [],
		"fav_count": "3060",
		"fans_count": "21.7万",
		"freight": "快递: 免运费",
		"props_imgs": {
			"prop_img": [
				{
					"properties": "1627207:34664008",
					"url": "//img.alicdn.com/imgextra/i3/2209411885160/O1CN01gixXjQ1nzKRzXyMZz_!!2209411885160.jpg"
				}
			]
		},
		"_ddf": "xdl",
		"promo_type": null,
		"props_img": {
			"1627207:34664008": "//img.alicdn.com/imgextra/i3/2209411885160/O1CN01gixXjQ1nzKRzXyMZz_!!2209411885160.jpg"
		},
		"format_check": "ok",
		"shop_item": [],
		"relate_items": []
	},
	"error": "",
	"secache": "a634a954b21b0501cae9bf14ac01cbb8",
	"secache_time": 1665558261,
	"secache_date": "2022-10-12 15:04:21",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:97 max:10000 all[502=97+38+367];expires:2030-12-31",
	"execution_time": "1.529",
	"server_time": "Beijing/2022-10-12 15:04:21",
	"client_ip": "106.6.37.140",
	"call_args": {
		"num_iid": "670709161783",
		"is_promotion": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "5.98MB",
	"request_id": "gw-1.634666f468ea8",
	"last_id": "1277971560"
}