开发背景：
随着电商行业的不断发展，人们的购物需求日益增多。在购买商品时，很多人会通过搜索引擎、社交媒体等手段来获取信息或灵感。但是，在这些渠道中找到想要的商品并不容易，因为其中可能会混杂着一些广告或无关内容。
为了让消费者更加方便地搜索到自己想要的商品，许多电商平台开始探索按图搜索商品的功能。这种功能可以让消费者上传一张图片，然后根据该图片中的物品特征，自动匹配出相似的商品，并推荐给消费者。通过图片识别技术和大数据分析，能够大大提升商品搜索的准确度和效率，使得消费者能够更快速地找到自己需要的商品。
基于这种背景，各大电商平台开始逐步推出按图搜索商品的功能，并提供了相应的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 | 宝贝链接 |