每天一个电商API分享：淘宝/天猫关键字搜索店铺列表 API

电玩女神 2024-03-22 23:04 108阅读 0赞

淘宝/天猫搜索店铺列表 API 是一个强大而灵活的工具，可以帮助开发者在自己的应用中集成淘宝/天猫搜索店铺列表的功能。通过这个 API，开发者可以获取指定关键词下的店铺列表，并根据自己的需求自定义搜索条件。该 API 提供丰富的参数选项，使得开发者能够定制搜索结果的相关性和排序方式。

### 功能介绍： ###

1.  搜索店铺列表：根据关键词搜索店铺，并返回符合条件的店铺列表。
2.  定制搜索条件：可以通过参数选择店铺搜索的筛选条件，如地区、信誉等级、销量等。
3.  排序选项：提供多个排序选项，开发者可以根据自己的需求自定义搜索结果的排序方式，如销量、人气等。
4.  分页查询：支持分页查询，开发者可以自定义每页返回的店铺数量，实现分批加载数据。

### 应用业务： ###

淘宝/天猫搜索店铺列表 API 在很多电商类应用中都有广泛的应用。比如，一个购物导航类应用可以使用该 API 提供用户搜索店铺的功能，让用户能够方便地找到自己想要购买商品的店铺。另外，一些价格比较类的应用也可以利用该 API 获取特定商品的店铺列表，并根据价格、信誉等因素进行排序，为用户提供最优的购物选择。

### 参数说明： ###

公共参数

<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=女装&page=1&sort=

> 参数说明：q:搜索关键词  
> page:页数  
> sort:筛选(taobao-xin 星级、taobao-zhuan 钻石、taobao-huang 皇冠、taobao-jin 金冠)，例：sort=taobao-xin  
> shoptype:店铺类型(tmall：天猫、taobao：淘宝)

响应参数

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>可可里小姐</td> 
   <td>店铺名</td> 
  </tr> 
  <tr> 
   <td> <p>sid</p> </td> 
   <td>Bigint</td> 
   <td>0</td> 
   <td>108075468</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>user_num_id</p> </td> 
   <td>Bigint</td> 
   <td>0</td> 
   <td>1746960915</td> 
   <td>店铺ID</td> 
  </tr> 
  <tr> 
   <td> <p>zhuy</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>//shop108075468.taobao.com</td> 
   <td>店铺主页</td> 
  </tr> 
  <tr> 
   <td> <p>pic_url</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>//g-search1.alicdn.com/img/bao/uploaded/i4///img.alicdn.com//1e/d2/TB1gmj.GpXXXXXKXVXXSutbFXXX.jpg</td> 
   <td>宝贝图片</td> 
  </tr> 
  <tr> 
   <td> <p>nick</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>好孩子v</td> 
   <td>掌柜名字</td> 
  </tr> 
  <tr> 
   <td> <p>area</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>山东</td> 
   <td>店铺所在地</td> 
  </tr> 
  <tr> 
   <td> <p>tag</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>sold</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>item_total</p> </td> 
   <td>Bigint</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>rate</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>99.16%</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>rank</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>20</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>rank_icon</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>crown_5</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>dsr</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>{"sgr": 99.16%,"ind":"服饰鞋包"}</td> 
   <td>服务描述</td> 
  </tr> 
  <tr> 
   <td> <p>shop_type</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>c</td> 
   <td>店铺类型</td> 
  </tr> 
  <tr> 
   <td> <p>consumer_protection</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>1</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>is_golden_seller</p> </td> 
   <td>Bool</td> 
   <td>0</td> 
   <td>山东</td> 
   <td>店铺所在地</td> 
  </tr> 
  <tr> 
   <td> <p>item</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>店铺列表</td> 
  </tr> 
 </tbody> 
</table>

### 调用示例： （支持以下方式） ###

### ![a8a54b385ee74fc28361eeb4764a063e.png][] ###

Python

# coding:utf-8
    """
    Compatible for python2.x and python3.x
    requirement: pip install requests
    """
    from __future__ import print_function
    import requests
    # 请求示例 url 默认请求参数已经做URL编码
    url = "https://api-服务器.cn/taobao/item_search_seller/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&page=1&sort="
    headers = {
        "Accept-Encoding": "gzip",
        "Connection": "close"
    }
    if __name__ == "__main__":
        r = requests.get(url, headers=headers)
        json_obj = r.json()
        print(json_obj)

以上是一个简单的调用示例，通过指定关键词为“手机”、地区为“北京”、排序选项为“销量”，可以获取到两个符合条件的店铺列表，并返回店铺的相关信息，如店铺名称、店铺链接、销量和信誉等级。

### 总结 ###

淘宝/天猫搜索店铺列表 API 是一个功能强大的工具，可以帮助开发者实现搜索店铺列表的功能，并根据自己的需求定制搜索条件和排序方式。该 API 在电商类应用中有广泛的应用场景，可以提升用户体验，帮助用户快速找到合适的店铺。

[a8a54b385ee74fc28361eeb4764a063e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/916e5f7333314655a7b70037ba78d5b0.png