淘宝商品列表API使用指南

淘宝商品列表 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.x
requirement: pip install requests
"""
from __future__ import print_function
import 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)

审核编辑 黄宇