淘寶商品列表 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=&secret=&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)

審核編輯 黃宇