重要接口关键词搜索——item_search-按关键字搜索淘宝商品

前往测试接口

一、请求参数

请求参数：q=蓝牙耳机&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数\

二、响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0		商品标题
pic_url	String	0		宝贝图片
promotion_price	Float	0		优惠价
price	Float	0		价格
sales	Int	0		销量
num_iid	Bigint	0		宝贝ID
sample_id	String	0		商品风格标识ID
seller_nick	String	0		掌柜昵称
post_fee	Float	0		物流费用
area	String	0		店铺所在地
detail_url	String	0		宝贝链接
seller_info	Mix	0		卖家信息

三、请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="

四、响应示例

	"page": "1",
	"page_no": "1",
	"real_total_results": "336054",
	"total_results": "336054",
	"page_size": "10",
	"pagecount": "100",
	"item": [
		{
			"title": "2022年新款真无线蓝牙耳机运动型适用小米oppo华为vivo安卓iphone通用微小型单耳迷你挂耳式入耳男女士款可爱",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/1788093809/O1CN01oJIZwL1e0ZLbf2Ofd_!!0-item_pic.jpg",
			"promotion_price": "9.9",
			"price": "9.9",
			"sales": "4万+",
			"num_iid": "595653059936",
			"seller_nick": "幽炫数码专营店",
			"area": "广东 东莞",
			"seller_id": "1788093809",
			"detail_url": "https://detail.tmall.com/item.htm?id=595653059936&skuId=4363586197383&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.0"
		},
		{
			"title": "【单次通话48小时】迷你蓝牙耳机运动入耳适用于华为苹果安卓通用",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2211658388658/O1CN01eLdcG02DpPq6taCVF_!!0-item_pic.jpg",
			"promotion_price": "12.8",
			"price": "12.8",
			"sales": "7000+",
			"num_iid": "655361323179",
			"seller_nick": "外势旗舰店",
			"area": "广东 深圳",
			"seller_id": "2211658388658",
			"detail_url": "https://detail.tmall.com/item.htm?id=655361323179&skuId=4721533632875&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.1"
		},
		{
			"title": "官方原装正品蓝牙耳机2022年新款真无线适用华为苹果oppo小米运动",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3955173308/O1CN01hgZWp01aJ6xWREBu8_!!0-item_pic.jpg",
			"promotion_price": "22.8",
			"price": "22.8",
			"sales": "2万+",
			"num_iid": "674943493228",
			"seller_nick": "尔野数码专营店",
			"area": "广东 深圳",
			"seller_id": "3955173308",
			"detail_url": "https://detail.tmall.com/item.htm?id=674943493228&skuId=4852740484420&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.2"
		},
		{
			"title": "迪士尼无线蓝牙耳机2021年新款适用苹果oppo小米vivo音质超好原装正品女生正版旗舰店联名官方迪斯尼米奇1438",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i4/2616970884/O1CN01wGwORx1IOus2nctaD_!!0-item_pic.jpg",
			"promotion_price": "58.0",
			"price": "58.0",
			"sales": "1万+",
			"num_iid": "668520365928",
			"seller_nick": "苏宁易购官方旗舰店",
			"area": "广东 深圳",
			"seller_id": "2616970884",
			"detail_url": "https://detail.tmall.com/item.htm?id=668520365928&skuId=4810373008231&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.3"
		},
		{
			"title": "夏新真无线蓝牙耳机高品质降噪入耳式运动游戏超长续航2022年新款音质超好男生女士适用苹果vivo华为oppo小米",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2683605376/O1CN01HobKlZ1paFzYqmRKR_!!0-item_pic.jpg",
			"promotion_price": "19.8",
			"price": "19.8",
			"sales": "6万+",
			"num_iid": "562161593312",
			"seller_nick": "amoi夏新安凯欣专卖店",
			"area": "广东 东莞",
			"seller_id": "2683605376",
			"detail_url": "https://detail.tmall.com/item.htm?id=562161593312&skuId=4498170576002&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.4"
		},
		{
			"title": "小米12原装蓝牙耳机适用红米k50k40无线2022年新款note11pro女406",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/3175118387/O1CN01StXCoj2BpIZKaW3pG_!!0-item_pic.jpg",
			"promotion_price": "48.0",
			"price": "48.0",
			"sales": "2000+",
			"num_iid": "677743184651",
			"seller_nick": "苏宁易购官方旗舰店",
			"area": "广东 深圳",
			"seller_id": "2616970884",
			"detail_url": "https://detail.tmall.com/item.htm?id=677743184651&skuId=4865303932253&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.5"
		},
		{
			"title": "huawei华为适用蓝牙耳机真无线运动原装正品2022年新款男女款降噪",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i2/3937219703/O1CN01Qoy1P82LY1nbrQz9h_!!3937219703-0-C2M.jpg",
			"promotion_price": "39.9",
			"price": "39.9",
			"sales": "1万+",
			"num_iid": "675369617500",
			"seller_nick": "天天特卖工厂店",
			"area": "浙江 杭州",
			"seller_id": "3937219703",
			"detail_url": "https://detail.tmall.com/item.htm?id=675369617500&skuId=4859291805004&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.6"
		},
		{
			"title": "苹果蓝牙耳机正品四代真无线4代原装2022年新款苹果13华强北1438",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i4/2616970884/O1CN01jXl2VJ1IOutS6Fe38_!!0-item_pic.jpg",
			"promotion_price": "49.0",
			"price": "49.0",
			"sales": "200+",
			"num_iid": "680520662859",
			"seller_nick": "苏宁易购官方旗舰店",
			"area": "浙江 金华",
			"seller_id": "2616970884",
			"detail_url": "https://detail.tmall.com/item.htm?id=680520662859&skuId=5047581566612&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.7"
		},
		{
			"title": "无线蓝牙耳机双耳迷你超小入耳运动华为OPPO小米vivo苹果安卓通用",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i4/2211658388658/O1CN01XDjpUY2DpPtOsaH0S_!!0-item_pic.jpg",
			"promotion_price": "29.9",
			"price": "29.9",
			"sales": "1000+",
			"num_iid": "674319244844",
			"seller_nick": "外势旗舰店",
			"area": "广东 深圳",
			"seller_id": "2211658388658",
			"detail_url": "https://detail.tmall.com/item.htm?id=674319244844&skuId=4851632204778&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.8"
		},
		{
			"title": "迪士尼正版联名款无线真蓝牙耳机适用苹果oppo小米vivo女正品1438",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2616970884/O1CN01knP0AA1IOutJGQVRI_!!0-item_pic.jpg",
			"promotion_price": "58.0",
			"price": "58.0",
			"sales": "300+",
			"num_iid": "678849672148",
			"seller_nick": "苏宁易购官方旗舰店",
			"area": "浙江 金华",
			"seller_id": "2616970884",
			"detail_url": "https://detail.tmall.com/item.htm?id=678849672148&skuId=4870097020828&channelTraceId=search_213fca1d16608700350406276eb60f&spm=a1z60.7754815.item.9"
		}
	],
	"data_from": "tianmiao",
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:16 max:10100 all[53=16+19+18];expires:2030-12-31",
	"execution_time": "3.197",
	"server_time": "Beijing/2022-08-19 08:47:17",
	"client_ip": "106.6.39.226",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_new",
	"server_memory": "5.86MB",
	"request_id": "1.62fedd926b594",
	"last_id": "1160737019"
}