一、引言淘宝关键词搜索商品列表 API 是淘宝开放平台提供的核心接口之一,允许开发者通过关键词检索平台商品数据,适用于比价工具、选品系统、市场分析等多种场景。该接口支持多种搜索条件和排序方式,返回包含商品 ID、标题、价格、销量等关键信息的结构化数据。二、接口概述
关键参数说明
基础参数:
q:搜索关键词(如"女装")page_no:页码(默认 1)page_size:每页数量(默认 20,最大 100)sort:排序方式(如"sale-desc"销量降序)
筛选参数:
start_price/end_price:价格区间is_tmall:是否只显示天猫商品has_coupon:是否显示有优惠券商品
三、Python 请求示例
# coding:utf-8"""Compatible for python2.x and python3.xrequirement: pip install requests"""from __future__ import print_functionimport requests# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " app_key = "YOUR_APP_KEY"# 请求示例 url 默认请求参数已经做URL编码url = "taobao/item_search/?key=<您自己的apiKey>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="headers = { "Accept-Encoding": "gzip", "Connection": "close"}if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)
复制代码
备注:
频率限制:默认 QPS 为 1 次/秒。字段过滤:使用 fields 参数精简返回字段(如 fields="title,price")提升性能。错误处理:需捕获"流量不足"、"参数错误"等 API 返回码。测试环境:建议先在沙箱环境测试接口调用。
评论