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

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

注冊(cè)淘寶開(kāi)放平臺(tái)賬號(hào)并創(chuàng)建應(yīng)用。

獲取 AppKey 和 AppSecret。

完成應(yīng)用實(shí)名認(rèn)證及權(quán)限申請(qǐng)。

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

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

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

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

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

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

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

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

?安裝依賴?：pip install requests。

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

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(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)

審核編輯 黃宇