按图搜索1688商品（拍立淘） API 返回值说明

为了进行此平台API的调用，首先我们需要做下面几件事情。

1、 获取一个KEY。

2、 参考API文档里的接入方式和示例。

3、查看测试工具是否有需要的接口，响应实例的返回字段是否符合参数要求。

4、利用平台的文档中心和API测试工具，对接口进行测试、程序获取。

更多API调用展示以及获取Key和secret请移步

公共参数

名称	类型	必须	描述
key	String	是	调用key  点击获取测试key和secret
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=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg

参数说明：imgid:图片地址（使用淘宝upload_img接口上传图片，返回图片地址）
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg

响应参数

Version: Date:

名称	类型	必须	示例值	描述
items	items[]	0		按图搜索1688商品
real_total_results	Int	0	80	宝贝真实数量
total_results	Int	0	43	搜索数量
pagecount	Int	0	1	总页数
error	String	0		错误代码
data_from	String	0
item	item[]	0		宝贝详情数据
title	String	0	外贸儿童短袖T恤 夏季热销套装 时尚儿童T	宝贝标题
pic_url	String	0	https://cbu01.alicdn.com/img/ibank/2016/998/799/2913997899_1588191881.jpg	宝贝图片
price	Float	0	7.00	价格
sales	Int	0	5	销量
num_iid	Bigint	0	529502304128	宝贝ID
turnHead	String	0	23.5%	回头率
seller_nick	String	0	中山市汇锦制衣有限公司	卖家昵称
area	String	0	广东中山市	店铺所在地
detail_url	String	0	https://detail.1688.com/offer/529502304128.html	宝贝 接

返回结果

{
	"items": {
		"real_total_results": 80,
		"error": "",
		"item": [
			{
				"title": "儿童实战篮球袜小中学生吸汗运动袜子童款防滑毛巾底中筒球袜批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01u0I4a42C84k3qEnHR_!!3325968428-0-cib.jpg",
				"price": "6.63",
				"promotion_price": "6.98",
				"sales": 5936,
				"num_iid": "652576197463",
				"turnHead": "17%",
				"seller_nick": "佛山市南海领途袜业有限公司",
				"area": "佛山市",
				"detail_url": "https://detailp4p.1688.com/buyer/offerdetail/652576197463.html?trace_log=p4p"
			},
			{
				"title": "情缘  袜子男士  足球袜  运动袜  提花袜  定制袜  长筒袜男定制",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/453/042/9067240354_1968951043.jpg",
				"price": "2.00",
				"promotion_price": "2.00",
				"sales": 0,
				"num_iid": "572614452815",
				"turnHead": "4%",
				"seller_nick": "诸暨市情缘针纺股份有限公司",
				"area": "诸暨市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=572614452815&sortType=&pageId=&abBizDataType=cbuOffer&pvid=6b68d7c8-28d4-40c4-9979-797be27dfe78&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "中筒篮球袜男成人儿童运动袜子女高帮精英运动欧文科比篮球袜跨境",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VGOxId25ZpP9mAzlg_!!2330137541-0-cib.jpg",
				"price": "8.50",
				"promotion_price": "8.50",
				"sales": 1378,
				"num_iid": "642615635023",
				"turnHead": "24%",
				"seller_nick": "晋安区跃飞服饰经营部",
				"area": "福州市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=642615635023&sortType=&pageId=&abBizDataType=cbuOffer&pvid=6b68d7c8-28d4-40c4-9979-797be27dfe78&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "运动肌能压缩袜专业压力袜跑步女跳绳健身骑行登山压力瘦腿长高弹",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01q7fQdD1z22a4mp6zZ_!!2207535316655-0-cib.jpg",
				"price": "8.50",
				"promotion_price": "8.50",
				"sales": 7933,
				"num_iid": "677656575419",
				"turnHead": "15%",
				"seller_nick": "诸暨市漫跑针织厂",
				"area": "诸暨市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=677656575419&sortType=&pageId=&abBizDataType=cbuOffer&pvid=6b68d7c8-28d4-40c4-9979-797be27dfe78&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "中筒潮袜篮球袜中筒男毛巾底成人专业实战健身运动袜精英袜子",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01I0sIbw2GdSOuhgxta_!!992399038-0-cib.jpg",
				"price": "4.00",
				"promotion_price": "4.00",
				"sales": 260,
				"num_iid": "674693104823",
				"turnHead": "11%",
				"seller_nick": "佛山市曹师傅织造有限公司",
				"area": "佛山市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=674693104823&sortType=&pageId=&abBizDataType=cbuOffer&pvid=6b68d7c8-28d4-40c4-9979-797be27dfe78&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "Sport'sHouse运动之家男士中筒渐变实战篮球精英袜专业运动袜子潮",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01pkRwBr1EaaUe9UkLW_!!2213220760368-0-cib.jpg",
				"price": "29.72",
				"promotion_price": "29.72",
				"sales": 272,
				"num_iid": "669128960837",
				"turnHead": "21%",
				"seller_nick": "浙江运动之家纺织科技有限公司",
				"area": "绍兴市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=669128960837&sortType=&pageId=&abBizDataType=cbuOffer&pvid=6b68d7c8-28d4-40c4-9979-797be27dfe78&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "袜子男 精英篮球加厚运动袜中筒网眼户外实战透气厂家批发 中筒袜",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01jWjHWo1wp64YHqWcH_!!3956