淘寶商品列表 API（通常指 taobao.items.search 接口）允許開發(fā)者通過關(guān)鍵詞、類目等條件檢索商品數(shù)據(jù)，適用于比價工具、市場分析等場景。以下指南涵蓋接口核心功能、調(diào)用步驟、參數(shù)說明及代碼示例。

接口核心功能與調(diào)用前提：該接口支持按關(guān)鍵詞、價格區(qū)間、銷量等條件篩選商品，返回結(jié)構(gòu)化數(shù)據(jù)（如商品 ID、標題、價格、銷量）。調(diào)用前需完成以下準備：

注冊淘寶開放平臺賬號并創(chuàng)建應(yīng)用。

獲取 AppKey 和 AppSecret。

完成應(yīng)用實名認證及權(quán)限申請。

接口地址正式環(huán)境：c0b.cc/R4rbK2(前往體驗接口測試，Taobaoapi2014 添加 V 獲取）。

接口調(diào)用頻率限制通常為 100 次/秒（普通應(yīng)用），建議先在沙箱環(huán)境測試。

請求參數(shù)與簽名機制：請求需包含基礎(chǔ)參數(shù)和可選篩選參數(shù)。

基礎(chǔ)參數(shù)：app_key（必填，應(yīng)用標識）、method（固定為 taobao.items.search）、timestamp（時間戳，格式 yyyy-MM-dd HH:mm:ss）、format（固定為 json）、v（固定為 2.0）、sign（接口簽名）。

查詢參數(shù)：q（搜索關(guān)鍵詞，如"女裝"）、page_no（頁碼，默認 1）、page_size（每頁條數(shù)，默認 20，最大 100）、sort（排序方式，如 sale-desc 銷量降序）。

篩選參數(shù)：如 start_price/end_price（價格區(qū)間）、is_tmall（是否僅天貓商品）。

簽名生成采用 MD5 算法：將參數(shù)按鍵名 ASCII 碼升序拼接，前后添加 AppSecret，經(jīng) MD5 加密后轉(zhuǎn)大寫。

?Python 調(diào)用示例：? 以下為完整調(diào)用流程，基于 Python 3.7+和 requests 庫。?

?安裝依賴?：pip install requests。

?代碼實現(xiàn)?：

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請求示例 url 默認請求參數(shù)已經(jīng)做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)

審核編輯 黃宇