关键词获取商品详情返回值说明

Hardy的博客

已于 2022-10-09 10:06:32 修改

阅读量149

点赞数

分类专栏：电商数据 API 文章标签： json

于 2022-10-09 08:53:08 首次发布

本文链接：https://blog.csdn.net/t79036912/article/details/127220029

版权

数据同时被 3 个专栏收录

52 篇文章 0 订阅

订阅专栏

API

40 篇文章 2 订阅

订阅专栏

电商

24 篇文章 1 订阅

订阅专栏

想要通过API接口调取数据，我们需要做下面几件事情：

获取一个KEY。
参考API文档里的接入方式和示例。
查看测试工具是否有需要的接口，响应实例的返回字段是否符合参数要求。
利用平台的文档中心和API测试工具，对接口进行测试、程序获取。
更多API调用展示可以点击获取Key和secret

1、公共参数

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

2、请求参数

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

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

响应参数

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	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
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	[]

3、响应示例

{
	"item": {
		"num_iid": "594891929659",
		"title": "现摘广西七彩椒新鲜辣椒9斤蔬菜五彩椒泡椒小灯笼椒米椒包邮特10",
		"desc_short": "",
		"price": 23.8,
		"orginal_price": "98.00",
		"nick": "探味君旗舰店",
		"num": "200",
		"pic_url": "https://img.alicdn.com/imgextra/i1/2271279753/O1CN01TOwyJB2LuvZ8LftzA_!!2271279753.jpg",
		"brand": "探味君",
		"brandId": "726060111",
		"rootCatId": "50050359",
		"cid": "201172307",
		"crumbs": null,
		"detail_url": "https://item.taobao.com/item.htm?id=594891929659",
		"desc": "<p>&nbsp;</p> \n  <p><img src=\"http://img.alicdn.com/imgextra/i3/2271279753/O1CN01DFRnBt2LuvQpxAcVX_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01Y9ezn22LuvQqwYXq4_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i1/2271279753/O1CN01w8hajY2LuvQrtowoy_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01f0eddY2LuvQuvcYHD_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01pZreEc2LuvQsVD6LX_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01q5VD372LuvQuvdDr1_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2271279753/O1CN01rKhSpk2LuvQqO8KOM_!!2271279753.jpg\" align=\"absmiddle\" /><img src=\"http://img.alicdn.com/imgextra/i2/2271279753/O1CN01yX2Eyy2LuvQsmIglG_!!2271279753.jpg\" align=\"absmiddle\" /></p><img src=\"https://www.o0b.cn/i.php?t.png&rid=1.628a14022626f&p=794351287&k=o.com&t=1653216261\" style=\"display:none\" />",
		"item_imgs": [
			{
				"url": "https://img.alicdn.com/imgextra/i1/2271279753/O1CN01TOwyJB2LuvZ8LftzA_!!2271279753.jpg"
			},
			{
				"url": "https://img.alicdn.com/imgextra/i3/2271279753/O1CN01xF7Noe2LuvX8YASGX_!!2271279753.jpg"
			},
			{
				"url": "https://img.alicdn.com/imgextra/i1/2271279753/O1CN01B8wn6E2LuvX4bw0cv_!!2271279753.jpg"
			},
			{
				"url": "https://img.alicdn.com/imgextra/i1/2271279753/O1CN01R0Gfe32LuvX4bw4mq_!!2271279753.jpg"
			},
			{
				"url": "https://img.alicdn.com/imgextra/i1/2271279753/O1CN01Y8Ohsw2LuvX0mfyV1_!!2271279753.jpg"
			}
		],
		"item_weight": 0,
		"location": "广西南宁",
		"post_fee": 0,
		"express_fee": 0,
		"ems_fee": 0,
		"shipping_to": "",
		"has_discount": "true",
		"video": {
			"pic": "https://img.alicdn.com/imgextra/i1/2271279753/O1CN01TOwyJB2LuvZ8LftzA_!!2271279753.jpg",
			"url": "https://cloud.video.taobao.com/play/u/2271279753/p/2/e/6/t/1/325817834811.mp4?appKey=38829"
		},
		"is_virtual": null,
		"sample_id": "",
		"is_promotion": "true",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "",
		"props": [
			{
				"name": "品牌",
				"value": "探味君"
			},
			{
				"name": "产地",
				"value": "中国大陆"
			},
			{
				"name": "省份",
				"value": "广西壮族自治区"
			},
			{
				"name": "地市",
				"value": "南宁市"
			},
			{
				"name": "包装方式",
				"value": "食用农产品"
			},
			{
				"name": "上市时间",
				"value": "9月 3月 11月 6月 1月 7月 4月 2月 10月 5月 12月 8月"
			},
			{
				"name": "蔬菜种类",
				"value": "七彩椒"
			},
			{
				"name": "净含量",
				"value": "500g 1000g 1500g 2500g 4500g"
			},
			{
				"name": "储存条件",
				"value": "常温"
			},
			{
				"name": "食用方式",
				"value": "其他"
			},
			{
				"name": "厂名",
				"value": "探味君旗舰店"
			},
			{
				"name": "厂址",
				"value": "探味君旗舰店"
			},
			{
				"name": "厂家联系方式",
				"value": "18676962036"
			},
			{
				"name": "保质期",
				"value": "7"
			}
		],
		"props_name": "147956252:75368623:净含量:500g;147956252:92219:净含量:1000g;147956252:5441080:净含量:1500g;147956252:7429095:净含量:2500g;147956252:17185405:净含量:4500g",
		"total_sold": 189050000,
		"skus": {
			"sku": [
				{
					"price": "23.8",
					"total_price": 0,
					"promotion_price": "23.8",
					"orginal_price": "23.8",
					"properties": "147956252:75368623",
					"properties_name": "147956252:75368623:净含量:500g",
					"quantity": "200",
					"sku_id": "4850123020718"
				},
				{
					"price": "30.8",
					"total_price": 0,
					"promotion_price": "30.8",
					"orginal_price": "30.8",
					"properties": "147956252:92219",
					"properties_name": "147956252:92219:净含量:1000g",
					"quantity": "200",
					"sku_id": "4850123020719"
				},
				{
					"price": "39.8",
					"total_price": 0,
					"promotion_price": "39.8",
					"orginal_price": "39.8",
					"properties": "147956252:5441080",
					"properties_name": "147956252:5441080:净含量:1500g",
					"quantity": "200",
					"sku_id": "4850123020716"
				},
				{
					"price": "52.8",
					"total_price": 0,
					"promotion_price": "52.8",
					"orginal_price": "52.8",
					"properties": "147956252:7429095",
					"properties_name": "147956252:7429095:净含量:2500g",
					"quantity": "200",
					"sku_id": "4850123020717"
				},
				{
					"price": "89.8",
					"total_price": 0,
					"promotion_price": "89.8",
					"orginal_price": "89.8",
					"properties": "147956252:17185405",
					"properties_name": "147956252:17185405:净含量:4500g",
					"quantity": "200",
					"sku_id": "4850123020715"
				}
			]
		},
		"seller_id": "2271279753",
		"shop_id": "114628945",
		"props_list": {
			"147956252:75368623": "净含量:500g",
			"147956252:92219": "净含量:1000g",
			"147956252:5441080": "净含量:1500g",
			"147956252:7429095": "净含量:2500g",
			"147956252:17185405": "净含量:4500g"
		},
		"seller_info": {
			"nick": "探味君旗舰店",
			"item_score": "4.5 ",
			"score_p": "4.6 ",
			"delivery_score": "4.6 ",
			"shop_type": "B",
			"user_num_id": "2271279753",
			"sid": "114628945",
			"title": "探味君旗舰店",
			"zhuy": "https://shop114628945.taobao.com/",
			"shop_name": "探味君旗舰店"
		},
		"tmall": true,
		"update_time": "2022-05-22 18:44:21",
		"data_update": "2022-05-22 18:44:21",
		"data_f": "cfg",
		"data_from": "hid",
		"promo_type": null,
		"props_img": [],
		"error": null,
		"format_check": "ok",
		"sales": 0,
		"desc_img": [
			"http://img.alicdn.com/imgextra/i3/2271279753/O1CN01DFRnBt2LuvQpxAcVX_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01Y9ezn22LuvQqwYXq4_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i1/2271279753/O1CN01w8hajY2LuvQrtowoy_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01f0eddY2LuvQuvcYHD_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01pZreEc2LuvQsVD6LX_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i4/2271279753/O1CN01q5VD372LuvQuvdDr1_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i2/2271279753/O1CN01rKhSpk2LuvQqO8KOM_!!2271279753.jpg",
			"http://img.alicdn.com/imgextra/i2/2271279753/O1CN01yX2Eyy2LuvQsmIglG_!!2271279753.jpg",
			"https://www.o0b.cn/i.php?t.png&rid=1.628a14022626f&p=794351287&k=o.com&t=1653216261"
		],
		"shop_item": [],
		"relate_items": []
	},
	"error": "",
	"secache": "efae93c4ea5146c03207a4f4b632b608",
	"secache_time": 1661912518,
	"secache_date": "2022-08-31 10:21:58",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:36 max:10100 all[76=36+10+30];expires:2030-12-31",
	"execution_time": "0.57",
	"server_time": "Beijing/2022-08-31 10:21:58",
	"client_ip": "106.6.34.182",
	"call_args": {
		"num_iid": "594891929659",
		"is_promotion": "1"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "5.89MB",
	"request_id": "gw-3.630ec5c59c1e6",
	"last_id": "1186218345"
}