淘宝通过关键字搜索商品列表API接口对接详细步骤（支持免费测试）

快来打我* 2024-02-05 17:59 19阅读 0赞

![66ce4566ab9e4188980b8807b36aa93e.png][]

通过关键字搜索商品，批量获取到相关商品，这是几乎所有电商平台购物商城都有的功能。我将此功能封装为API，可供外部软件直接调用，实现通过关键字搜索淘宝商品的功能。

接口名称：item\_search-按关键字搜索淘宝商品

请求地址: [taobao.item\_search][taobao.item_search]

公共参数

<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>

请求参数

请求参数：q=女装&start\_price=0&end\_price=0&page=1&cat=0&discount\_only=&sort=&page\_size=&seller\_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字  
cat:分类ID  
start\_price:开始价格  
end\_price:结束价格  
sort:排序\[bid,\_bid,bid2,\_bid2,\_sale,\_credit\]  
(bid:总价,bid2:商品价格,sale:销量,credit信用,加\_前缀为从大到小排序)  
page:页数

响应参数

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>法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装</td> 
   <td>商品标题</td> 
  </tr> 
  <tr> 
   <td> <p>pic_url</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>//img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg</td> 
   <td>宝贝图片</td> 
  </tr> 
  <tr> 
   <td> <p>promotion_price</p> </td> 
   <td>Float</td> 
   <td>0</td> 
   <td>178.00</td> 
   <td>优惠价</td> 
  </tr> 
  <tr> 
   <td> <p>price</p> </td> 
   <td>Float</td> 
   <td>0</td> 
   <td>178.00</td> 
   <td>价格</td> 
  </tr> 
  <tr> 
   <td> <p>sales</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>890</td> 
   <td>销量</td> 
  </tr> 
  <tr> 
   <td> <p>num_iid</p> </td> 
   <td>Bigint</td> 
   <td>0</td> 
   <td>577437133060</td> 
   <td>宝贝ID</td> 
  </tr> 
  <tr> 
   <td> <p>seller_nick</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>初穆旗舰店</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>//detail.tmall.com/item.htm?id=586794298909&amp;ns=1&amp;abbucket=0</td> 
   <td>宝贝链接</td> 
  </tr> 
 </tbody> 
</table>

错误码解释

<table> 
 <thead> 
  <tr> 
   <th>状态代码(error_code)</th> 
   <th>状态信息</th> 
   <th>详细描述</th> 
   <th>是否收费</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0000</td> 
   <td>success</td> 
   <td>接口调用成功并返回相关数据</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>2000</td> 
   <td>Search success but no result</td> 
   <td>接口访问成功，但是搜索没有结果</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>4000</td> 
   <td>Server internal error</td> 
   <td>服务器内部错误</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>4001</td> 
   <td>Network error</td> 
   <td>网络错误</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>4002</td> 
   <td>Target server error</td> 
   <td>目标服务器错误</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>4003</td> 
   <td>Param error</td> 
   <td>用户输入参数错误</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4004</td> 
   <td>Account not found</td> 
   <td>用户帐号不存在</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4005</td> 
   <td>Invalid authentication credentials</td> 
   <td>授权失败</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4006</td> 
   <td>API stopped</td> 
   <td>您的当前API已停用</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4007</td> 
   <td>Account stopped</td> 
   <td>您的账户已停用</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4008</td> 
   <td>API rate limit exceeded</td> 
   <td>并发已达上限</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4009</td> 
   <td>API maintenance</td> 
   <td>API维护中</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4010</td> 
   <td>API not found with these values</td> 
   <td>API不存在</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4012</td> 
   <td>Please add api first</td> 
   <td>请先添加api</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4013</td> 
   <td>Number of calls exceeded</td> 
   <td>调用次数超限</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4014</td> 
   <td>Missing url param</td> 
   <td>参数缺失</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4015</td> 
   <td>Wrong pageToken</td> 
   <td>参数pageToken有误</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4016</td> 
   <td>Insufficient balance</td> 
   <td>余额不足</td> 
   <td>忽略</td> 
  </tr> 
  <tr> 
   <td>4017</td> 
   <td>timeout error</td> 
   <td>请求超时</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>5000</td> 
   <td>unknown error</td> 
   <td>未知错误</td> 
   <td>否</td> 
  </tr> 
 </tbody> 
</table>

[66ce4566ab9e4188980b8807b36aa93e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/7875723adaeb471c9e494876e238cec3.png
[taobao.item_search]: https://o0b.cn/jennif