淘宝/天猫按图搜索淘宝商品（拍立淘）

item_search_img-按图搜索淘宝商品（拍立淘）  快速注册开通测试

onebound.taobao.item_search_img

公共参数

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

请求参数

请求参数：imgid=g-search3.alicdn.com/img/bao/upl…

参数说明：imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址）
如:img.alicdn.com/imgextra/i3…

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮	宝贝标题
cid	Int	0	50015374
list_type	String	0	外观相似宝贝	列表类型
pic_url	String	0	//g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg	宝贝图片
promotion_price	String	0	38.71	优惠价
price	Float	0	39.50	价格
sales	Int	0	7	销量
num_iid	Bigint	0	575727312808	宝贝ID
sample_id	Bigint	0	1627115368	商品风格标识ID
seller_nick	String	0	专属味道之dzw	掌柜昵称
is_tmall	Bool	0	false
post_fee	String	0	0.00	物流费用
area	String	0	广东 东莞	店铺所在地
detail_url	String	0	//item.taobao.com/item.htm?id=575727312808&ns=1#detail	宝贝链接

请求示例

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

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat="

响应示例

	"items": {
		"pagecount": 1,
		"total_results": 30,
		"real_total_results": 30,
		"item": [
			{
				"title": "斯伯丁篮球袜中长筒高帮男女运动袜子防滑专业实战加厚毛巾袜秋冬",
				"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4//i1/1824010184/O1CN01Ou1vgn1DEJfPuUGMl_!!0-saturn_solar.jpg",
				"promotion_price": "19",
				"price": "19",
				"sales": 23,
				"num_iid": "658906601865",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "金华",
				"detail_url": "//item.taobao.com/item.htm?id=658906601865",
				"cid": null
			},
			{
				"title": "精英篮球袜男士成人加厚毛巾底中筒袜耐磨透气比赛专业运动球袜子",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01Yv88bu1wvVg0H7ADe_!!875286370.jpg",
				"promotion_price": "20",
				"price": "20",
				"sales": 0,
				"num_iid": "668987399113",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "广州",
				"detail_url": "//item.taobao.com/item.htm?id=668987399113",
				"cid": "50017261"
			},
			{
				"title": "Sports  House运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
				"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN017xjYWb2HVxXbwLIuU_!!82339157.jpg",
				"promotion_price": "39.9",
				"price": "39.9",
				"sales": 0,
				"num_iid": "678610269323",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=678610269323",
				"cid": "50015374"
			},
			{
				"title": "STANCE 短筒357五虎将系列专业实战中帮篮球袜精英袜运动袜子男",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01pWppuP1tUXWnVOpUl_!!2958825905.jpg",
				"promotion_price": "138",
				"price": "138",
				"sales": 257,
				"num_iid": "676020480856",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=676020480856",
				"cid": "50015374"
			},
			{
				"title": "落脚点Sports  House运动之家篮球袜男士实战精英袜透气运动袜",
				"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01zpwQO01O0zuk8h7yY_!!1649091644.jpg",
				"promotion_price": "9",
				"price": "9",
				"sales": 3,
				"num_iid": "684887563975",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=684887563975",
				"cid": "50015374"
			},
			{
				"title": "Sports  House运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01GEN7gN1mzxPFz3pm7_!!3894675026.jpg",
				"promotion_price": "9",
				"price": "9",
				"sales": 0,
				"num_iid": "683707856686",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=683707856686",
				"cid": "50015374"
			},
			{
				"title": "男女士加厚全棉袜子运动跑步篮球袜速干户外登山徒步袜防臭毛巾底",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/TB2rr4Dd2DH8KJjy1XcXXcpdXXa_!!2606084188.jpg",
				"promotion_price": "16.67",
				"price": "16.67",
				"sales": 17,
				"num_iid": "531085709413",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "金华",
				"detail_url": "//item.taobao.com/item.htm?id=531085709413",
				"cid": "50006846"
			},
			{
				"title": "JG军哥篮球袜子毛巾底实战长筒专业运动训练精英袜男跑步加厚高帮",
				"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN017lzcJJ1RdsHPxHyuK_!!1066772135.jpg",
				"promotion_price": "24",
				"price": "24",
				"sales": 8,
				"num_iid": "623750915688",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "泉州",
				"detail_url": "//item.taobao.com/item.htm?id=623750915688",
				"cid": "50017261"
			},
			{
				"title": "篮球袜长筒袜球袜中筒袜男士高筒高帮科比詹姆斯专业精英运动长袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01FtNA041YsG6bPAKzA_!!2001083114.jpg",
				"promotion_price": "15.8",
				"price": "15.8",
				"sales": 55,
				"num_iid": "675814622450",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "哈尔滨",
				"detail_url": "//item.taobao.com/item.htm?id=675814622450",
				"cid": "50017261"
			},
			{
				"title": "运动之家中筒篮球袜男士实战精英袜专业透气运动袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01mnNK1E1DbDSbBAZt0_!!1913230234.jpg",
				"promotion_price": "9.9",
				"price": "9.9",
				"sales": 0,
				"num_iid": "683510340428",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=683510340428",
				"cid": "50015374"
			},
			{
				"title": "中筒运动透气中筒篮球袜男士毛巾底实战精英袜专业运动袜",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01KdbRtr1rDvy2NAkhg_!!2215021425598.jpg",
				"promotion_price": "33.8",
				"price": "33.8",
				"sales": 0,
				"num_iid": "690242193197",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "绍兴",
				"detail_url": "//item.taobao.com/item.htm?id=690242193197",
				"cid": "50015374"
			},
			{
				"title": "准者球员实战专业篮球球袜男中筒高帮防滑毛巾底精英跑步运动袜子",
				"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01ohRWdT1TrHDD3MsYK_!!0-item_pic.jpg",
				"promotion_price": "22.9",
				"price": "22.9",
				"sales": 16,
				"num_iid": "672482222538",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "泉州",
				"detail_url": "//item.taobao.com/item.htm?id=672482222538",
				"cid": "50015374"
			},
			{
				"title": "库里勇士队汤普森篮球袜男高帮精英实战curry长筒运动专业毛巾袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01iInesG1pYskQxCMeA_!!552855373.jpg",
				"promotion_price": "29",
				"price": "29",
				"sales": 1,
				"num_iid": "648241921818",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "青岛",
				"detail_url": "//item.taobao.com/item.htm?id=648241921818",
				"cid": "50017261"
			},
			{
				"title": "UA库里8联名篮球袜子男中筒专业芝麻街实战毛巾底勇士精英Nba高筒",
				"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01zP0CPN1jTwmes3PdO_!!2770454550.png",
				"promotion_price": "20.9",
				"price": "20.9",
				"sales": 83,
				"num_iid": "647766251110",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "杭州",
				"detail_url": "//item.taobao.com/item.htm?id=647766251110",
				"cid": "50017261"
			},
			{
				"title": "UA毛巾底NBA球员版篮球袜精英袜库里中高筒专业训练加厚吸汗缓震",
				"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01VPXwqZ2HE65WuPTyo_!!519559118.jpg",
				"promotion_price": "12.9",
				"price": "12.9",
				"sales": 1,
				"num_iid": "676423099619",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "衢州",
				"detail_url": "//item.taobao.com/item.htm?id=676423099619",
				"cid": "50017261"
			},
			{
				"title": "库里30号儿童袜成年毛巾底篮球袜中高筒专业精英袜球星同号篮球袜",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01jOQrbU1ynNszBPRNs_!!2212656286623.jpg",
				"promotion_price": "19.9",
				"price": "19.9",
				"sales": 0,
				"num_iid": "669165045112",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "长沙",
				"detail_url": "//item.taobao.com/item.htm?id=669165045112",
				"cid": "50017261"
			},
			{
				"title": "球员版精英篮球袜男女中长筒高帮专业毛巾底棉花糖闪击七运动袜子",
				"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN016vmzPx1TJNmuEyCdR_!!1575692361.jpg",
				"promotion_price": "16",
				"price": "16",
				"sales": 17,
				"num_iid": "643708468558",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "杭州",
				"detail_url": "//item.taobao.com/item.htm?id=643708468558",
				"cid": "50015374"
			},
			{
				"title": "篮球袜子中长筒短筒高帮跑步袜男士户外专业运动加厚毛巾底精英袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01tiizk31ph7k5Vutd4_!!271045391.jpg",
				"promotion_price": "6.8",
				"price": "6.8",
				"sales": 11,
				"num_iid": "600321872541",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "杭州",
				"detail_url": "//item.taobao.com/item.htm?id=600321872541",
				"cid": "50017261"
			},
			{
				"title": "领途实战篮球袜男款防滑吸汗运动球袜毛巾底高帮中筒青年足球袜子",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01RxWV8K2J9dTULPHrr_!!171429379.jpg",
				"promotion_price": "10.9",
				"price": "10.9",
				"sales": 2,
				"num_iid": "681182669452",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "杭州",
				"detail_url": "//item.taobao.com/item.htm?id=681182669452",
				"cid": "50015374"
			},
			{
				"title": "JumpStart 拼色篮球精英袜 虎扑jrs推荐潮流拼多色缓压减震运动袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN013FYcgw28Zm8lM3eeL_!!3231177947.jpg",
				"promotion_price": "29",
				"price": "29",
				"sales": 3,
				"num_iid": "620280486317",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=620280486317",
				"cid": "50015374"
			},
			{
				"title": "UZIS AJ11康扣concord加厚毛巾底男女篮球袜潮流AJ配袜精英篮球袜",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN016vY9Yf240GzQTgiCN_!!909767328-0-lubanu-s.jpg",
				"promotion_price": "39.99",
				"price": "39.99",
				"sales": 0,
				"num_iid": "584654149571",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "广州",
				"detail_url": "//item.taobao.com/item.htm?id=584654149571",
				"cid": "50015374"
			},
			{
				"title": "取步篮球袜子专业运动春夏中筒男女长短筒防滑毛巾底蓝球精英袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01NfrUsx1cNLanul6Ek_!!3619313588.jpg",
				"promotion_price": "17",
				"price": "17",
				"sales": 0,
				"num_iid": "589830258342",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "广州",
				"detail_url": "//item.taobao.com/item.htm?id=589830258342",
				"cid": "50017261"
			},
			{
				"title": "精英篮球袜子男短袜夏季薄款中筒美式实战毛巾底专业跑步运动袜子",
				"pic_url": "http://g.search1.alicdn.com/img/bao/uploaded/i4/O1CN01l5Yeex24zBkhH55PQ_!!2207298697461.jpg",
				"promotion_price": "8.4",
				"price": "8.4",
				"sales": 15,
				"num_iid": "611069068828",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "杭州",
				"detail_url": "//item.taobao.com/item.htm?id=611069068828",
				"cid": "50017261"
			},
			{
				"title": "袜子实战专业篮球袜子毛巾底高筒运动精英男中筒高帮长筒训练美式",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01uyHOn52LY1oE0aOSk_!!3937219703.jpg",
				"promotion_price": "9.6",
				"price": "9.6",
				"sales": 493,
				"num_iid": "684487692361",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "杭州",
				"detail_url": "//item.taobao.com/item.htm?id=684487692361",
				"cid": "50017261"
			},
			{
				"title": "球星篮球袜男高筒运动高帮专业中长筒袜子实战训练科比詹姆斯球袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01EFzdCJ1JFaL98HRBD_!!2261100999.jpg",
				"promotion_price": "13.8",
				"price": "13.8",
				"sales": 4,
				"num_iid": "640928293526",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "金华",
				"detail_url": "//item.taobao.com/item.htm?id=640928293526",
				"cid": "50017261"
			},
			{
				"title": "nba篮球袜男高筒中筒高筒专业实战训练毛巾底加厚运动袜子精英袜",
				"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01rvZOB52Htm92IxXeH_!!750609209.jpg",
				"promotion_price": "18.8",
				"price": "18.8",
				"sales": 97,
				"num_iid": "691136387938",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "衢州",
				"detail_url": "//item.taobao.com/item.htm?id=691136387938",
				"cid": "50017261"
			},
			{
				"title": "左右力量篮球袜JG军哥联名款毛巾底实战长筒高帮精英运动袜跑步袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN01Jq4n9e2FcFbKvSRO4_!!2206637888900.jpg",
				"promotion_price": "26",
				"price": "26",
				"sales": 6,
				"num_iid": "624755140459",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "泉州",
				"detail_url": "//item.taobao.com/item.htm?id=624755140459",
				"cid": "50017261"
			},
			{
				"title": "准者袜男低帮短袜跑步运动袜中筒专业防滑篮球袜长筒袜加厚精英袜",
				"pic_url": "http://g.search2.alicdn.com/img/bao/uploaded/i4/O1CN01zl8TQn1TrH9tn8Nky_!!2181532435.jpg",
				"promotion_price": "9.9",
				"price": "9.9",
				"sales": 2267,
				"num_iid": "556682941324",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "泉州",
				"detail_url": "//item.taobao.com/item.htm?id=556682941324",
				"cid": "50015374"
			},
			{
				"title": "准者运动篮球袜子中筒专业实战球员版高帮毛巾底男高筒跑步精英袜",
				"pic_url": "http://g.search3.alicdn.com/img/bao/uploaded/i4/O1CN016yjrcV1uhC74FPfDX_!!2452776068.jpg",
				"promotion_price": "15.9",
				"price": "15.9",
				"sales": 49,
				"num_iid": "647325228189",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "泉州",
				"detail_url": "//item.taobao.com/item.htm?id=647325228189",
				"cid": "50015374"
			},
			{
				"title": "STANCE 中筒557儿童俩款专业实战高帮篮球袜精英袜运动袜子童袜",
				"pic_url": "http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN018KstbE1tUXWhhQdpw_!!2958825905.png",
				"promotion_price": "138",
				"price": "138",
				"sales": 11,
				"num_iid": "674328104659",
				"post_fee": null,
				"sample_id": "",
				"seller_nick": null,
				"is_tmall": "false",
				"area": "上海",
				"detail_url": "//item.taobao.com/item.htm?id=674328104659",
				"cid": "50017261"
			}
		],
		"data_from": "app_t"
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "805dd061d51a733c7a85711ba0a36267",
	"secache_time": 1667805508,
	"secache_date": "2022-11-07 15:18:28",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:104 max:10100 all[269=104+115+50];expires:2030-12-31",
	"execution_time": "8.381",
	"server_time": "Beijing/2022-11-07 15:18:28",
	"client_ip": "106.6.32.214",
	"call_args": {
		"imgid": "http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "6.29MB",
	"request_id": "gw-1.6368b13bd11f1",
	"last_id": "1339786729"
}

异常示例相关资料错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否