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

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

功能介绍：

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

应用业务：

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

参数说明：

公共参数

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

请求参数

请求参数：q=女装&page=1&sort=

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

响应参数

Version: Date:

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

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

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 在电商类应用中有广泛的应用场景，可以提升用户体验，帮助用户快速找到合适的店铺。