淘宝商品详情 API（taobao.item.get）完整使用教程

method        = taobao.item.get
app_key       = 你的AppKey
timestamp     = 2026-03-23 15:30:00
format        = json
v             = 2.0
sign          = 自动生成（SHA256）

num_iid = 689123456789       # 商品ID（从链接?id=后面获取）
fields  = 你需要获取的字段

num_iid,title,price,promotion_price,pic_url,detail_url,sold_quantity,volume,num,props_name,seller_nick,shop_id,approve_status,item_imgs,sku,desc

import requests
import hashlib
from datetime import datetime
# 签名生成
def create_sign(params, app_secret):
    sorted_params = sorted(params.items())
    base_str = ''.join(f"{k}{v}" for k, v in sorted_params)
    base_str = app_secret + base_str + app_secret
    sign = hashlib.sha256(base_str.encode('utf-8')).hexdigest().upper()
    return sign
# 调用淘宝商品详情API
def get_item_detail(app_key, app_secret, num_iid):
    url = "https://eco.taobao.com/router/rest"
    
    # 构造参数
    params = {
        "method": "taobao.item.get",
        "app_key": app_key,
        "timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "num_iid": num_iid,
        "fields": "num_iid,title,price,promotion_price,pic_url,detail_url,sold_quantity,volume,num,props_name,seller_nick,shop_id,approve_status,item_imgs,sku,desc"
    }
    
    # 生成签名
    params["sign"] = create_sign(params, app_secret)
    
    # 发送请求
    resp = requests.post(url, data=params)
    return resp.json()
# ==================== 调用示例 ====================
if __name__ == '__main__':
    APP_KEY = "你的AppKey"
    APP_SECRET = "你的AppSecret"
    NUM_IID = "689123456789"  # 商品ID
    
    result = get_item_detail(APP_KEY, APP_SECRET, NUM_IID)
    print(result)

{
  "item_get_response": {
    "item": {
      "num_iid": 689123456789,
      "title": "2026新款夏季纯棉T恤女宽松显瘦百搭短袖上衣",
      "price": "59.00",
      "promotion_price": "49.00",
      "pic_url": "https://img.alicdn.com/imgextra/i1/123456789/XXX.jpg",
      "detail_url": "https://item.taobao.com/item.htm?id=689123456789",
      "sold_quantity": 12800,
      "volume": 2860,
      "num": 3500,
      "props_name": "品牌:XX;材质:纯棉;尺码:S/M/L/XL;风格:休闲;",
      "seller_nick": "XX品牌旗舰店",
      "shop_id": 987654321,
      "approve_status": "onsale",
      "item_imgs": [
        {
          "url": "https://img.alicdn.com/imgextra/i1/123456789/XXX1.jpg"
        },
        {
          "url": "https://img.alicdn.com/imgextra/i1/123456789/XXX2.jpg"
        },
        {
          "url": "https://img.alicdn.com/imgextra/i1/123456789/XXX3.jpg"
        }
      ],
      "sku": [
        {
          "sku_id": 1287654321,
          "properties_name": "颜色:白色;尺码:M",
          "price": "59.00",
          "quantity": 860,
          "spec_img": "https://img.alicdn.com/imgextra/i1/123456789/XXX-sku1.jpg"
        },
        {
          "sku_id": 1287654322,
          "properties_name": "颜色:黑色;尺码:L",
          "price": "59.00",
          "quantity": 720,
          "spec_img": "https://img.alicdn.com/imgextra/i1/123456789/XXX-sku2.jpg"
        }
      ],
      "desc": "<div class=\"detail-content\">...</div>"
    },
    "request_id": "2lsqk7v1m92o"
  }
}