拍立淘API接口说明文档 按图搜索淘宝商品API 实时数据返回

开发背景：

随着电商行业的不断发展，人们的购物需求日益增多。在购买商品时，很多人会通过搜索引擎、社交媒体等手段来获取信息或灵感。但是，在这些渠道中找到想要的商品并不容易，因为其中可能会混杂着一些广告或无关内容。
为了让消费者更加方便地搜索到自己想要的商品，许多电商平台开始探索按图搜索商品的功能。这种功能可以让消费者上传一张图片，然后根据该图片中的物品特征，自动匹配出相似的商品，并推荐给消费者。通过图片识别技术和大数据分析，能够大大提升商品搜索的准确度和效率，使得消费者能够更快速地找到自己需要的商品。
基于这种背景，各大电商平台开始逐步推出按图搜索商品的功能，并提供了相应的API接口，供开发者集成到自己的应用程序中使用。通过API接口，开发者可以方便地访问电商平台的按图搜索商品功能，实现与相应平台的数据交互，展示推荐商品，以及支持消费者进行一键购买等操作。
因此，为了更好地满足消费者的需求，并优化搜索体验，按图搜索商品API接口应运而生。

API名称：item_search_img

功能介绍：通过传入请求参数imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址），获取商品信息列表，商品信息包括：宝贝标题、列表类型、宝贝图片、优惠价、价格、销量、宝贝ID、商品风格标识ID、掌柜昵称、物流费用、店铺所在地、宝贝链接。

公共参数：

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

调用示例（PHP）：

支持curl、PHP、Java、JavaScript、c#、Python、JS-SDK、Ruby、Swift、objective-C、C、C++、Node.JS、Kotlin、Rust、R、MATLAB等多种语言调用

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://o0b.cn/jennif
$method = "GET";
$url = "https://api-服务器.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

响应参数

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	宝贝链接