一、引言淘宝关键词搜索商品列表 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.x
requirement: pip install requests
"""
from __future__ import print_function
import 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 返回码。测试环境:建议先在沙箱环境测试接口调用。
评论