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

- 日理万妓 2024-03-22 17:27 26阅读 0赞

**开发背景：**

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

![9e092b575580bfa37e2061880aa3bd53.jpeg][]

**API名称：**[item\_search\_img][item_search_img]

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

公共参数：

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>key</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用key（必须以GET方式拼接在URL中）</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用密钥</td> 
  </tr> 
  <tr> 
   <td>api_name</td> 
   <td>String</td> 
   <td>是</td> 
   <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
  </tr> 
  <tr> 
   <td>result_type</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
  </tr> 
  <tr> 
   <td>lang</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>String</td> 
   <td>否</td> 
   <td>API版本</td> 
  </tr> 
 </tbody> 
</table>

**调用示例（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:

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

[9e092b575580bfa37e2061880aa3bd53.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/5ddb757255264d16bbe8e053ccc444b0.png
[item_search_img]: https://o0b.cn/jennif