淘宝/天猫搜索店铺列表 API 是一个强大而灵活的工具,可以帮助开发者在自己的应用中集成淘宝/天猫搜索店铺列表的功能。通过这个 API,开发者可以获取指定关键词下的店铺列表,并根据自己的需求自定义搜索条件。该 API 提供丰富的参数选项,使得开发者能够定制搜索结果的相关性和排序方式。
功能介绍:
- 搜索店铺列表:根据关键词搜索店铺,并返回符合条件的店铺列表。
- 定制搜索条件:可以通过参数选择店铺搜索的筛选条件,如地区、信誉等级、销量等。
- 排序选项:提供多个排序选项,开发者可以根据自己的需求自定义搜索结果的排序方式,如销量、人气等。
- 分页查询:支持分页查询,开发者可以自定义每页返回的店铺数量,实现分批加载数据。
应用业务:
淘宝/天猫搜索店铺列表 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 在电商类应用中有广泛的应用场景,可以提升用户体验,帮助用户快速找到合适的店铺。