淘宝商品列表 API(通常指 taobao.items.search 接口)允许开发者通过关键词、类目等条件检索商品数据,适用于比价工具、市场分析等场景。以下指南涵盖接口核心功能、调用步骤、参数说明及代码示例。
接口核心功能与调用前提: 该接口支持按关键词、价格区间、销量等条件筛选商品,返回结构化数据(如商品 ID、标题、价格、销量)。调用前需完成以下准备:
注册淘宝开放平台账号并创建应用。
获取 AppKey 和 AppSecret。
完成应用实名认证及权限申请。
接口地址正式环境:c0b.cc/R4rbK2 (前往体验接口测试,Taobaoapi2014 添加 V 获取)。
接口调用频率限制通常为 100 次/秒(普通应用),建议先在沙箱环境测试。
请求参数与签名机制: 请求需包含基础参数和可选筛选参数。
基础参数:app_key(必填,应用标识)、method(固定为 taobao.items.search)、timestamp(时间戳,格式 yyyy-MM-dd HH:mm:ss)、format(固定为 json)、v(固定为 2.0)、sign(接口签名)。
查询参数:q(搜索关键词,如"女装")、page_no(页码,默认 1)、page_size(每页条数,默认 20,最大 100)、sort(排序方式,如 sale-desc 销量降序)。
筛选参数:如 start_price/end_price(价格区间)、is_tmall(是否仅天猫商品)。
签名生成采用 MD5 算法:将参数按键名 ASCII 码升序拼接,前后添加 AppSecret,经 MD5 加密后转大写。
Python 调用示例: 以下为完整调用流程,基于 Python 3.7+和 requests 库。
安装依赖:
pip install requests。代码实现:
# coding:utf-8"""Compatible for python2.x and python3.xrequirement: pip install requests"""from __future__ import print_functionimport requests# 请求示例 url 默认请求参数已经做URL编码url = "taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&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)