阿里巴巴中国站按图搜索1688商品(拍立淘) API 返回值说明

160 阅读6分钟

item_search_img-按图搜索1688商品(拍立淘) 前往注册开通测试

onebound.1688.item_search_img

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:imgid=cbu01.alicdn.com/img/ibank/2…

参数说明:imgid:图片地址(使用淘宝upload_img接口上传图片,返回图片地址)
如:cbu01.alicdn.com/img/ibank/2…

响应参数

Version: Date:

名称类型必须示例值描述
itemsitems[]0按图搜索1688商品
real_total_resultsInt080宝贝真实数量
total_resultsInt043搜索数量
pagecountInt01总页数
errorString0错误代码
data_fromString0
itemitem[]0宝贝详情数据

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=https://cbu01.alicdn.com/img/ibank/2020/082/017/18255710280_1694867894.jpg

响应示例

{
	"items": {
		"real_total_results": 80,
		"error": "",
		"item": [
			{
				"title": "正品超大量充电宝超薄80000毫安便携大容量小巧100000毫安闪快充",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01DoeYUa1pkKjFAw6G0_!!2201235165398-0-cib.jpg",
				"price": "90.00",
				"promotion_price": "90.00",
				"sales": 803,
				"num_iid": "637323599860",
				"turnHead": "15%",
				"seller_nick": "深圳市二筒科技有限公司",
				"area": "深圳市",
				"detail_url": "https://detailp4p.1688.com/buyer/offerdetail/637323599860.html?trace_log=p4p"
			},
			{
				"title": "一件代发50000毫安创意充电宝 大容量快充镜面数显新款移动电源",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/219/220/19129022912_2146186101.jpg",
				"price": "60.00",
				"promotion_price": "60.00",
				"sales": 527,
				"num_iid": "624163377086",
				"turnHead": "23%",
				"seller_nick": "深圳市灵电科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=624163377086&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "一件代发大容量充电宝50000毫安60000毫安数显快充10W移动电源8万",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/999/810/21587018999_40970201.jpg",
				"price": "63.70",
				"promotion_price": "70.00",
				"sales": 44025,
				"num_iid": "619661034684",
				"turnHead": "14%",
				"seller_nick": "深圳腾之乐科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=619661034684&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "40000毫安大容量充电宝 跨境新款快充镜面数显移动电源power bank",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/702/367/22107763207_1142018016.jpg",
				"price": "53.58",
				"promotion_price": "53.58",
				"sales": 1376,
				"num_iid": "630280362319",
				"turnHead": "23%",
				"seller_nick": "深圳市乔电实业有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=630280362319&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "批发新款大容量充电宝50000毫安数显快充镜面移动电源礼品印logo",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01GvBGHG1GHvVZetneX_!!2210883920598-0-cib.jpg",
				"price": "15.50",
				"promotion_price": "15.50",
				"sales": 3264,
				"num_iid": "639268403261",
				"turnHead": "28%",
				"seller_nick": "深圳市福田区美佳蒂电子厂",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=639268403261&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "野外长续航大容量移动电源50000毫安四口输出数显充电宝mAh厂家",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/829/241/15131142928_1758897933.jpg",
				"price": "58.00",
				"promotion_price": "58.00",
				"sales": 11262,
				"num_iid": "617678290667",
				"turnHead": "35%",
				"seller_nick": "深圳市中骏贸易有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=617678290667&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "批发新款镜面大容量充电宝50000毫安数显快充移动电源可定 制logo",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01yCA7l61pkKjNw6cCp_!!2201235165398-0-cib.jpg",
				"price": "75.00",
				"promotion_price": "75.00",
				"sales": 3138,
				"num_iid": "622676707500",
				"turnHead": "15%",
				"seller_nick": "深圳市二筒科技有限公司",
				"area": "深圳市",
				"detail_url": "https://detailp4p.1688.com/buyer/offerdetail/622676707500.html?trace_log=p4p"
			},
			{
				"title": "野外大容量50000毫安充电宝 全面屏数显镜面快充跨境通用移动电源",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN012Qkg4X1kung4XGXAz_!!2200755994744-0-cib.jpg",
				"price": "59.00",
				"promotion_price": "59.00",
				"sales": 1171,
				"num_iid": "657028890722",
				"turnHead": "34%",
				"seller_nick": "深圳市迅嘉宝电子有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=657028890722&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "新款镜面屏数显移动电源50000毫安 多输入口快充大容量充电宝批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01KONQGm2GepVK4652W_!!3502409041-0-cib.jpg",
				"price": "13.00",
				"promotion_price": "13.00",
				"sales": 12787,
				"num_iid": "614203324880",
				"turnHead": "29%",
				"seller_nick": "深圳市福田区隆达数码商行",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=614203324880&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": null,
				"pic_url": null,
				"price": null,
				"promotion_price": null,
				"sales": null,
				"num_iid": null,
				"turnHead": null,
				"seller_nick": null,
				"area": null,
				"detail_url": null
			},
			{
				"title": "50000快充大容量充电宝创成达品牌充电宝便携式镜面新款一件代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01K0GSXx1lLoxxFjarX_!!2631714803-0-cib.jpg",
				"price": "43.50",
				"promotion_price": "43.50",
				"sales": 991,
				"num_iid": "639674763329",
				"turnHead": "28%",
				"seller_nick": "深圳市创成达电子科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=639674763329&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "跨境大容量40000毫安充电宝热爆款powerbank手机通用移动电源定制",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01XqIup61JPCg7IPg7Z_!!2207260711020-0-cib.jpg",
				"price": "58.00",
				"promotion_price": "58.00",
				"sales": 28,
				"num_iid": "649413448390",
				"turnHead": "36%",
				"seller_nick": "恰恰(深圳)实业有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=649413448390&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "正品超大量充电宝超薄80000毫安便携大容量小巧100000毫安闪快充",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01DoeYUa1pkKjFAw6G0_!!2201235165398-0-cib.jpg",
				"price": "90.00",
				"promotion_price": "90.00",
				"sales": 803,
				"num_iid": "637323599860",
				"turnHead": "15%",
				"seller_nick": "深圳市二筒科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=637323599860&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "40000毫安大容量充电宝 跨境新款快充镜面数显移动电源power bank",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN011kxjXR2NbLrM2iWyJ_!!2207992979981-0-cib.jpg",
				"price": "59.00",
				"promotion_price": "59.00",
				"sales": 12,
				"num_iid": "663686361609",
				"turnHead": "7%",
				"seller_nick": "深圳市睿诚隆科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=663686361609&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "跨境外贸大容量50000毫安充电宝 整面屏快充数显移动电源礼品5万",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/449/653/18704356944_2120013892.jpg",
				"price": "65.00",
				"promotion_price": "65.00",
				"sales": 432,
				"num_iid": "650608245195",
				"turnHead": "36%",
				"seller_nick": "深圳市创鑫晨科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=650608245195&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "大容量充电宝40000毫安数显快充移动电源 POWER BANK礼品印制批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/134/343/19444343431_1516337895.jpg",
				"price": "57.00",
				"promotion_price": "57.00",
				"sales": 20,
				"num_iid": "625100119603",
				"turnHead": "11%",
				"seller_nick": "深圳市普尔科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=625100119603&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "跨境大容量50000毫安充电宝 全面屏数显快充野外续航通用移动电源",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/494/916/14976619494_1717085673.jpg",
				"price": "81.00",
				"promotion_price": "81.00",
				"sales": 8355,
				"num_iid": "617203158986",
				"turnHead": "10%",
				"seller_nick": "深圳市钜晟达贸易有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=617203158986&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "全面屏数显50000毫安大容量充电宝快充户外移动电源定制powerbank",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/412/149/15467941214_547130262.jpg",
				"price": "78.00",
				"promotion_price": "78.00",
				"sales": 8,
				"num_iid": "618230814300",
				"turnHead": "5%",
				"seller_nick": "深圳市佳音杰科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=618230814300&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "批发大容量手机充电宝80000毫安便携移动电源100000毫安闪快充",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01zACkP327AIeRFOVWr_!!2213074697756-0-cib.jpg",
				"price": "88.11",
				"promotion_price": "88.11",
				"sales": 12,
				"num_iid": "665915496830",
				"turnHead": "11%",
				"seller_nick": "东莞市旺捷科技有限公司",
				"area": "东莞市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=665915496830&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			},
			{
				"title": "40000毫安超大容量快充手机充电宝 外贸跨境专供户外便携移动电源",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/458/828/18806828854_138296141.jpg",
				"price": "58.00",
				"promotion_price": "58.00",
				"sales": 311,
				"num_iid": "623453168907",
				"turnHead": "8%",
				"seller_nick": "深圳市博鸿恒业科技有限公司",
				"area": "深圳市",
				"detail_url": "http://detail.m.1688.com/page/index.html?offerId=623453168907&sortType=&pageId=&abBizDataType=cbuOffer&pvid=e2d4103c-fc75-437a-a68a-b9828b1cff88&trace_log=normal&scm=1007.38073.268722.0"
			}
		],
		"data_from": "ti",
		"pagecount": 1,
		"total_results": 20
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "9bd897ccb6bcbeb8368ee75dd496b022",
	"secache_time": 1663917041,
	"secache_date": "2022-09-23 15:10:41",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:14 max:10100 all[50=14+2+34];expires:2030-12-31",
	"execution_time": "1.658",
	"server_time": "Beijing/2022-09-23 15:10:41",
	"client_ip": "106.6.38.190",
	"call_args": {
		"imgid": "https://cbu01.alicdn.com/img/ibank/2020/082/017/18255710280_1694867894.jpg"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "4.17MB",
	"request_id": "gw-3.632d5befb6af5",
	"last_id": "1236514798"
}