关键字搜索天猫商品列表API调用示例分享

admin4个月前 (06-10)淘宝API158

item_search_tmall-按关键字搜索天猫商品

用API搜索“女装”，返回结果如下：

"page": "1",	"real_total_results": 77079,	"total_results": 77079,	"page_size": 10,	"pagecount": 7708,	"_ddf": "cdy",	"item": [
		{			"title": "圆领短T恤/短袖优衣库女装26春夏新款483455",			"pic_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i1/196993935/O1CN01K0iwtW1ewHfGCYB9s_!!196993935.jpg",			"promotion_price": 59,			"orginal_price": 59,			"price": 59,			"sales": 10000,			"num_iid": 978357952661,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=978357952661"
		},
		{			"title": "竹节纱V领T恤/短袖优衣库女装/纯棉打底休闲百搭26春夏新款483460",			"pic_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i4/196993935/O1CN01SKOtOf1ewHetpg89n_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 79,			"orginal_price": 79,			"price": 79,			"sales": 100000,			"num_iid": 1003072702825,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=1003072702825"
		},
		{			"title": "常规款优衣库女装麻混纺舒适长裤/休闲裤26春夏新款482246",			"pic_url": "https://g.search2.alicdn.com/img/bao/uploaded/i4/i2/196993935/O1CN01xVrF3J1ewHf8Je0bI_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 149,			"orginal_price": 149,			"price": 149,			"sales": 10000,			"num_iid": 980072398082,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=980072398082"
		},
		{			"title": "优衣库合作款/女装圆领T恤/短袖正肩大师T素色483456",			"pic_url": "https://g.search3.alicdn.com/img/bao/uploaded/i4/i2/196993935/O1CN01YJ5cYs1ewHf2jZdER_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 79,			"orginal_price": 79,			"price": 79,			"sales": 10000,			"num_iid": 982204445525,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=982204445525"
		},
		{			"title": "休闲长裤/防紫外线优衣库女装常规款运动裤26春夏新款483001",			"pic_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i3/196993935/O1CN01EcpG0o1ewHfDY7GGX_!!196993935.jpg",			"promotion_price": 199,			"orginal_price": 199,			"price": 199,			"sales": 10000,			"num_iid": 998977944200,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=998977944200"
		},
		{			"title": "优衣库合作款/女装SUPIMA COTTON短袖T恤/圆领纯棉打底内搭483461",			"pic_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i1/196993935/O1CN01a0vKrP1ewHfH1Jxcw_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 79,			"orginal_price": 79,			"price": 79,			"sales": 10000,			"num_iid": 1012343444681,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=1012343444681"
		},
		{			"title": "麻混纺舒适长裤/加长款优衣库女装/休闲裤26春夏新款483904",			"pic_url": "https://g.search2.alicdn.com/img/bao/uploaded/i4/i1/196993935/O1CN01Io6rLz1ewHf3a1Yfk_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 149,			"orginal_price": 149,			"price": 149,			"sales": 10000,			"num_iid": 1001806170830,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=1001806170830"
		},
		{			"title": "优衣库女装舒适长裤/泡泡纱休闲裤26春夏新款483908",			"pic_url": "https://g.search3.alicdn.com/img/bao/uploaded/i4/i4/196993935/O1CN017XxcL51ewHfHzyzrw_!!196993935.jpg",			"promotion_price": 99,			"orginal_price": 99,			"price": 99,			"sales": 10000,			"num_iid": 1009872298181,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=1009872298181"
		},
		{			"title": "优衣库女装针织打褶中裤26春夏新款485178",			"pic_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i1/196993935/O1CN01u7Rp981ewHfBCvA90_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 199,			"orginal_price": 199,			"price": 199,			"sales": 10000,			"num_iid": 1012066354637,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=1012066354637"
		},
		{			"title": "优衣库女装法国麻衬衫/长袖衬衣26春夏新款483868",			"pic_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i3/196993935/O1CN015fLQ0g1ewHf4zS4um_!!4611686018427380623-0-item_pic.jpg",			"promotion_price": 299,			"orginal_price": 299,			"price": 299,			"sales": 10000,			"num_iid": 1004225110088,			"area": "上海",			"seller_nick": "优衣库官方旗舰店",			"seller_id": 196993935,			"detail_url": "https://detail.tmall.com/item.htm?id=1004225110088"
		}
	],

公共参数

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

请求参数

请求参数：q=女装&page=1

参数说明：q:搜索关键字
page:页数【最大翻页100页】

响应参数

Version: Date:

名称	类型	示例值	描述
page	Int	1	页码
real_total_results	Int	1000	宝贝数量
total_results	Int	1000	宝贝数量
page_size	Int	10	接口返回数量
pagecount	Int	100	总页数
item	item[]		宝贝详情数据