关键词搜索（taobao.tbk.item.get）核心字段详解：淘宝 API 接口文档精读

https://eco.taobao.com/router/rest

{
  "tbk_item_get_response": {
    "request_id": "89a7s6d87a6s8d7",
    "item": {
      "num_iid": "1234567890",
      "title": "2025新款无线蓝牙耳机 超长续航 官方正品",
      "pict_url": "https://img.alicdn.com/imgextra/i1/xxx.jpg",
      "price": "199.00",
      "zk_final_price": "99.00",
      "sales": "5万+",
      "user_type": 0,
      "nick": "数码优选店",
      "commission_rate": "30.00",
      "commission": "29.70",
      "coupon_amount": "50.00",
      "coupon_click_url": "https://s.click.taobao.com/t?e=xxx"
    }
  }
}

pip install requests hashlib

import requests
import time
import hashlib
from urllib.parse import urlencode

class TaobaoTbkItemClient:
    """淘宝客taobao.tbk.item.get接口客户端"""
    def __init__(self, app_key, app_secret):
        self.app_key = app_key  # 你的App Key
        self.app_secret = app_secret  # 你的App Secret
        self.gateway = "https://eco.taobao.com/router/rest"

    def _generate_sign(self, params):
        """生成淘宝API签名（核心逻辑）"""
        # 1. 按参数名ASCII升序排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        # 2. 拼接参数键值对（无分隔符）
        sign_str = ""
        for key, value in sorted_params:
            if value != "" and value is not None:  # 跳过空值
                sign_str += f"{key}{value}"
        # 3. 首尾拼接App Secret并MD5加密，转大写
        sign_str = self.app_secret + sign_str + self.app_secret
        sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
        return sign

    def get_item_info(self, num_iid, platform=1, fields=None):
        """
        查询商品详情
        :param num_iid: 商品ID，多个用英文逗号分隔（如"123456,789012"）
        :param platform: 平台类型 1=淘宝 2=天猫
        :param fields: 需返回的字段，默认返回全部
        :return: 解析后的商品信息字典
        """
        # 1. 构造基础参数
        params = {
            "method": "taobao.tbk.item.get",
            "app_key": self.app_key,
            "format": "json",
            "v": "2.0",
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
            "num_iid": num_iid,
            "platform": platform,
            "sign": ""  # 先留空，后续生成
        }
        # 2. 补充可选字段
        if fields:
            params["fields"] = fields

        # 3. 生成签名并赋值
        params["sign"] = self._generate_sign(params)

        # 4. 发送POST请求（推荐POST，避免GET参数长度限制）
        try:
            response = requests.post(self.gateway, data=params, timeout=10)
            response.raise_for_status()  # 抛出HTTP错误
            result = response.json()
        except requests.exceptions.RequestException as e:
            raise Exception(f"请求失败：{str(e)}")

        # 5. 解析响应（处理嵌套结构）
        if "tbk_item_get_response" not in result:
            raise Exception(f"接口返回异常：{result}")
        
        item_data = result["tbk_item_get_response"].get("item", {})
        # 字段格式化（统一转字符串/数字，避免后续处理异常）
        parsed_item = {
            "商品ID": item_data.get("num_iid", ""),
            "商品标题": item_data.get("title", "").strip(),
            "商品主图": item_data.get("pict_url", ""),
            "原价(元)": float(item_data.get("price", 0)),
            "折扣价(元)": float(item_data.get("zk_final_price", 0)),
            "销量": item_data.get("sales", ""),
            "店铺类型": "天猫店" if item_data.get("user_type") == 1 else "淘宝店",
            "卖家昵称": item_data.get("nick", ""),
            "佣金比例(%)": float(item_data.get("commission_rate", 0)),
            "佣金金额(元)": float(item_data.get("commission", 0)),
            "优惠券金额(元)": float(item_data.get("coupon_amount", 0)),
            "优惠券剩余数量": item_data.get("coupon_remain_count", 0),
            "推广链接": item_data.get("coupon_click_url", item_data.get("item_url", ""))
        }
        return parsed_item

# -------------------------- 示例调用 --------------------------
if __name__ == "__main__":
    # 替换为你的App Key和App Secret
    APP_KEY = "你的App Key"
    APP_SECRET = "你的App Secret"
    
    # 初始化客户端
    client = TaobaoTbkItemClient(APP_KEY, APP_SECRET)
    
    # 查询单个商品（替换为真实的商品ID）
    try:
        item_info = client.get_item_info(
            num_iid="1234567890",  # 真实商品ID
            platform=1,
            # 按需指定字段，减少数据量
            fields="num_iid,title,price,zk_final_price,commission_rate,commission,coupon_click_url"
        )
        print("商品详情：")
        for key, value in item_info.items():
            print(f"{key}: {value}")
    except Exception as e:
        print(f"查询失败：{str(e)}")