🛍️ 用淘宝官方API合规获取天猫商品数据——告别爬虫风控（附完整Demo）

一、前置准备

1. 注册 淘宝开放平台→ 创建应用（自用型/网站应用）

2. 获取 App Key+ App Secret

3. 申请接口权限：taobao.item.get（商品详情查询）

4. 天猫商品ID（num_iid）从商品URL提取：

   https://detail.tmall.com/item.htm?id=654321098765
   → num_iid = 654321098765

⚠️ 公开字段（标题/价格/主图/SKU规格）可不传 session；

卖家自己店铺商品的 SKU库存/商家编码 需传 卖家 AccessToken（OAuth2授权）。

二、Python完整Demo（签名 + 调用 + 字段解析）

# top_item_get_demo.py
"""
淘宝/天猫商品详情 官方API调用 Demo
依赖: top_api_client.TaobaoTopClient (签名 + POST封装)
—— 如你还没存过 client，下面附带最小化内联版本 ——
"""
import hashlib
import hmac
import time
import requests
import urllib.parse
from typing import Dict, List, Optional
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex

# ────────────────────────────────────────────────────────
# 内联最小化 TOP Client（复用你已有的也行）
# ────────────────────────────────────────────────────────
class TaobaoTopClient:
    PROD_GW = "https://gw.api.taobao.com/router/rest"
    SANDBOX = "https://gw.api.tbsandbox.com/router/rest"

    def __init__(self, app_key: str, app_secret: str, sandbox=False):
        self.ak = app_key
        self.as_ = app_secret
        self.gw = self.SANDBOX if sandbox else self.PROD_GW

    def _sign(self, params: Dict) -> str:
        filt = sorted((k, v) for k, v in params.items()
                      if v is not None and str(v).strip() != '' and k != 'sign')
        qs = ''.join(f"{k}{v}" for k, v in filt)
        return hashlib.md5(f"{self.as_}{qs}{self.as_}".encode()).hexdigest().upper()

    def call(self, method: str, biz: Dict, session: str = None) -> Dict:
        p = {
            "method": method,
            "app_key": self.ak,
            "timestamp": str(int(time.time() * 1000)),
            "format": "json",
            "v": "2.0",
            "sign_method": "md5"
        }
        if session:
            p["session"] = session
        p.update(biz)
        p["sign"] = self._sign(p)

        r = requests.post(self.gw, data=p, timeout=15)
        r.raise_for_status()
        d = r.json()
        if "error_response" in d:
            err = d["error_response"]
            raise Exception(f"TOP [{err.get('code')}]: {err.get('msg')} {err.get('sub_msg','')}")
        return d.get(list(d.keys() - {"error_response"})[0], {})


# ────────────────────────────────────────────────────────
# 核心：获取天猫/淘宝商品详情
# ────────────────────────────────────────────────────────
def get_tmall_item(client: TaobaoTopClient,
                   num_iid: str,
                   session: str = None,
                   fields: str = None) -> Dict:
    """
    Args:
        num_iid:  天猫/淘宝商品ID
        session:  卖家AccessToken（查自己店铺SKU库存必传）
        fields:   返回字段，逗号分隔
    Returns:
        item 字典
    """
    fields = fields or (
        "num_iid,title,price,org_price,pic_url,item_imgs,"
        "skus,props_name,desc,approve_status,num,outer_id,"
        "seller_nick,cid"
    )
    resp = client.call(
        "taobao.item.get",
        biz={"num_iid": num_iid, "fields": fields},
        session=session
    )
    return resp.get("item", resp)
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex

# ────────────────────────────────────────────────────────
# 解析并打印关键信息
# ────────────────────────────────────────────────────────
def print_item_summary(item: Dict):
    print(f"\n📦 商品ID : {item.get('num_iid')}")
    print(f"   标题   : {item.get('title')}")
    print(f"   一口价 : ¥{item.get('price')}")
    print(f"   原价   : ¥{item.get('org_price','—')}")
    print(f"   主图   : {item.get('pic_url')}")
    print(f"   库存   : {item.get('num')}")
    print(f"   状态   : {item.get('approve_status')}")

    skus = item.get("skus") or []
    if skus:
        print(f"   SKU数 : {len(skus)}")
        for sku in skus[:3]:
            print(f"     - {sku.get('properties_name','默认')} "
                  f"¥{sku.get('price')} 库:{sku.get('quantity')} "
                  f"商家码:{sku.get('outer_id','')}")
    else:
        print("   ℹ️  skus为空 → 查自己店铺商品需传 seller session")
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex

# =========================================================
# 使用示例
# =========================================================
if __name__ == "__main__":
    client = TaobaoTopClient(
        app_key="YOUR_TOP_APP_KEY",
        app_secret="YOUR_TOP_APP_SECRET",
        sandbox=False   # 生产直连
    )

    TMALL_ITEM_ID = "654321098765"   # ← 替换真实天猫/淘宝商品ID

    try:
        item = get_tmall_item(
            client,
            num_iid=TMALL_ITEM_ID,
            session=None,    # ← 自己店铺查库存/outer_id 传 SELLER_ACCESS_TOKEN
            fields="num_iid,title,price,org_price,pic_url,skus,num,approve_status,outer_id,props_name"
        )
        print_item_summary(item)

    except Exception as e:
        print("❌", e)
        print("→ 检查: AppKey/Secret正确、接口权限已申请、num_iid是有效商品ID")

三、关键返回字段（铺货/比价用）

四、避坑清单

五、面试/方案一句话

天猫/淘宝商品数据用官方 taobao.item.get(num_iid, fields)合规获取；公开字段不需 session，查自己店铺 SKU 库存/商家编码需传 卖家 OAuth AccessToken；签名按 TOP MD5 规则（参数ASCII升序拼 AppSecret+KV+AppSecret → 大写），完全替代爬虫杜绝风控封禁。