超详细：Python 调用淘宝商品详情 API 完整教程

（从 0 到 1，复制即可运行，新手也能看懂）

我给你写最干净、最稳定、无坑、可直接用于生产的版本，包含：

完整调用代码
签名函数
字段说明
常见错误解决
适合：闲鱼代发、无货源、商品采集、比价、ERP

一、你需要提前准备

淘宝开放平台 AppKey
AppSecret
已申请接口权限：taobao.item.get
一个商品 ID num_iid

二、安装依赖

bash

运行

复制代码

pip install requests

三、完整可运行代码（直接复制）

python

运行

复制代码

import requests
import hashlib
from datetime import datetime

# ===================== 配置区（改成你自己的） =====================
APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"
NUM_IID = "689000000000"  # 商品ID

# ===================== 签名生成（淘宝固定规则） =====================
def create_sign(params, secret):
    # 1. 参数按字母排序
    sorted_params = sorted(params.items())
    # 2. 拼接 key+value
    base_string = ''.join(f"{k}{v}" for k, v in sorted_params)
    # 3. 前后加上 AppSecret
    base_string = secret + base_string + secret
    # 4. SHA256 加密并转大写
    sign = hashlib.sha256(base_string.encode('utf-8')).hexdigest().upper()
    return sign

# ===================== 调用淘宝商品详情API =====================
def get_taobao_item_detail(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,pic_url,sku,detail_url,sold_quantity,volume"
    }

    # 生成签名
    params["sign"] = create_sign(params, APP_SECRET)

    # 发送请求
    response = requests.post(url, data=params)
    return response.json()

# ===================== 执行调用 =====================
if __name__ == "__main__":
    result = get_taobao_item_detail(NUM_IID)
    print(result)

四、运行后返回的标准 JSON 结构（你会收到这个）

json

复制代码

{
  "item_get_response": {
    "item": {
      "num_iid": 689000000000,
      "title": "2026新款夏季连衣裙",
      "price": "129.00",
      "pic_url": "https://img.alicdn.com/xxx.jpg",
      "detail_url": "https://item.taobao.com/item.htm?id=xxx",
      "sold_quantity": 1230,
      "volume": 320,
      "sku": [
        {
          "sku_id": 123456,
          "properties_name": "颜色:白色;尺码:L",
          "price": "129.00",
          "quantity": 100
        }
      ]
    }
  }
}

五、常用 fields（直接复制替换）

极简版（快、稳）

plaintext

复制代码

num_iid,title,price,pic_url,detail_url

标准版（90% 业务用）

plaintext

复制代码

num_iid,title,price,pic_url,sku,detail_url,sold_quantity,volume

完整版（含详情、主图）

plaintext

复制代码

num_iid,title,price,pic_url,item_imgs,sku,desc,detail_url,sold_quantity,volume

六、最常见 4 个错误（必看）

1. 错误码 15 → 签名错误

时间格式不对
AppSecret 错误
参数没有排序

2. 错误码 11 → 无权限

去淘宝开放平台申请 taobao.item.get

3. 错误码 27 → 商品不存在

ID 错误 / 商品下架

4. 错误码 429 → 调用频率超限

每秒不要超过 2 次
加缓存

七、这个代码能做什么业务？

✅ 闲鱼无货源代发（采集标题、图片、SKU）✅ 自动铺货工具✅ 商品比价小程序✅ 竞品销量监控✅ ERP 商品同步✅ 导购 / 返利网站