一、引言
淘宝关键词搜索商品列表API是淘宝开放平台提供的核心接口之一,允许开发者通过关键词检索平台商品数据,适用于比价工具、选品系统、市场分析等多种场景。该接口支持多种搜索条件和排序方式,返回包含商品ID、标题、价格、销量等关键信息的结构化数据。
二、接口概述
- 关键参数说明
基础参数:
q:搜索关键词(如"女装")
page_no:页码(默认1)
page_size:每页数量(默认20,最大100)
sort:排序方式(如"sale-desc"销量降序)
筛选参数:
start_price/end_price:价格区间
is_tmall:是否只显示天猫商品
has_coupon:是否显示有优惠券商品
三、Python请求示例
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返回码。
测试环境:建议先在沙箱环境测试接口调用。