一、前言

淘寶商品詳情 API 是獲取商品核心信息的核心接口，可返回商品的標題、價格、主圖、規格、庫存、銷量、店鋪信息等關鍵數據。
本指南嚴格遵循阿里開放平臺的接口規范，提供 接口概述、核心參數、Python 請求示例、異常處理 等內容，適用于 Python 開發者集成到電商相關系統中。

二、接口概述

以最常用的 taobao.item.get（獲取單個商品詳情） 為例，核心信息如下：

2.1 基礎信息

2.2 核心請求參數

2.3 典型返回字段（JSON）

json

{ "item_get_response": { "request_id": "123456", "item": { "num_iid": "1234567890", // 商品ID "title": "Python編程從入門到精通 正版圖書", // 商品標題 "price": "89.90", // 商品價格（元） "pic_url": "https://img.alicdn.com/xxx.jpg", // 商品主圖 "item_imgs": { // 商品輪播圖 "item_img": [ {"url": "https://img.alicdn.com/xxx1.jpg"}, {"url": "https://img.alicdn.com/xxx2.jpg"} ] }, "stock": 1000, // 商品庫存 "sales": 5000, // 商品銷量 "shop_name": "XX圖書專營店", // 店鋪名稱 "detail_url": "https://item.taobao.com/item.htm?id=1234567890" // 商品詳情頁URL } } }

2.4 常見響應碼

三、Python 請求示例

本示例提供 完整的簽名生成、接口調用、異常處理、數據解析 邏輯，適用于生產環境，遵循最佳實踐。

3.1 環境準備

安裝必要依賴：

bash

pip install requests python-dotenv

3.2 完整代碼實現

# 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_get/?key=&secret=&num_iid=652874751412&is_promotion=1"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

代碼亮點

敏感配置分離：使用 python-dotenv 加載 .env 文件，避免硬編碼 AppKey 和 AppSecret，提升代碼安全性；

完整的異常處理：覆蓋超時、連接錯誤、HTTP 狀態碼錯誤、接口返回錯誤等常見場景，避免程序崩潰；

嚴格的簽名算法：嚴格遵循阿里開放平臺的簽名規則，確保接口調用成功；

靈活的字段配置：支持自定義返回字段，可根據業務需求擴展；

清晰的字段解析：提取核心商品字段，并支持解析 SKU 規格列表，直接滿足代購系統的需求。

審核編輯 黃宇