淘寶商品列表API接口攻略（附代碼示例）

管理

編輯

刪除

OneLafite 2025-07-02 09:07:47

其他

一、接入前準備

注冊與認證訪問淘寶開放平臺/萬邦開放平臺，使用淘寶賬號登錄或注冊新賬號。完成企業(yè)/個人實名認證，提交營業(yè)執(zhí)照或身份證信息。
創(chuàng)建應(yīng)用登錄后進入「控制臺」→「應(yīng)用管理」→「創(chuàng)建應(yīng)用」。填寫應(yīng)用名稱、類型（如網(wǎng)頁/移動應(yīng)用）、回調(diào)地址等基本信息。提交審核后獲取AppKey和AppSecret，務(wù)必妥善保存。
申請API權(quán)限在應(yīng)用管理頁面，申請商品列表相關(guān)接口權(quán)限，例如： taobao.item.search（商品搜索） taobao.item_search_shop（按店鋪ID獲取商品）等待平臺審核（通常1-3個工作日）。

二、API調(diào)用流程

1. 生成訪問令牌（Access Token）

bash
POST https://oauth.taobao.com/token
Content-Type: application/x-www-form-urlencoded
 
grant_type=authorization_code
&client_id=YOUR_APPKEY
&client_secret=YOUR_APPSECRET
&code=授權(quán)碼（用戶授權(quán)后獲取）
&redirect_uri=回調(diào)地址

2. 構(gòu)造API請求

以商品搜索接口taobao.item.search為例，核心參數(shù)如下：

參數(shù)	必填	說明
`method`	是	接口名稱（如`taobao.item.search`）
`app_key`	是	你的AppKey
`timestamp`	是	當前時間戳（格式：YYYY-MM-DD HH:MM:SS）
`format`	是	返回格式（推薦`json`）
`v`	是	API版本（如`2.0`）
`sign_method`	是	簽名方法（`md5`或`hmac`）
`sign`	是	請求簽名（按規(guī)則生成）
`q`	否	搜索關(guān)鍵詞（如`女裝`）
`cat`	否	類目ID（如`16,18`表示服裝類目）
`page_no`	否	頁碼（默認`1`）
`page_size`	否	每頁數(shù)量（默認`20`，最大`100`）
`sort`	否	排序方式（如`price_asc`價格升序）

3. 生成簽名（MD5示例）

python
import hashlib
 
def generate_sign(params, app_secret):
    sorted_params = sorted(params.items())
    sign_str = app_secret
    for k, v in sorted_params:
        if k != "sign":
            sign_str += f"{k}{v}"
    sign_str += app_secret
    return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

4. 發(fā)送HTTP請求（Python示例）

python
import requests
import time
 
app_key = "YOUR_APPKEY"
app_secret = "YOUR_APPSECRET"
access_token = "YOUR_ACCESS_TOKEN"
 
url = "https://eco.taobao.com/router/rest"
params = {
    "method": "taobao.item.search",
    "app_key": app_key,
    "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
    "format": "json",
    "v": "2.0",
    "sign_method": "md5",
    "q": "女裝",
    "page_no": 1,
    "page_size": 50,
    "access_token": access_token
}
params["sign"] = generate_sign(params, app_secret)
 
response = requests.get(url, params=params)
data = response.json()
print(data)

三、響應(yīng)數(shù)據(jù)解析

成功響應(yīng)示例：

json
{
  "item_search_response": {
    "total_results": 1000,
    "items": [
      {
        "num_iid": "123456789",
        "title": "夏季新款連衣裙",
        "price": "199.00",
        "pic_url": "https://img.alicdn.com/xxx.jpg",
        "volume": 200  // 銷量
      }
    ]
  }
}