【实战教程】从零到一：调用淘宝商品 API 获取详情数据并解析

pip install requests pycryptodome beautifulsoup4 lxml

import hashlib
import sortedcontainers

def generate_sign(params, app_secret):
    # 1. 按参数名ASCII升序排序
    sorted_params = sortedcontainers.SortedDict(params)
    # 2. 拼接参数为"key=value&key=value"格式
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params.items()])
    # 3. 拼接App Secret
    sign_str += f"&secret={app_secret}"
    # 4. MD5加密（32位小写）
    sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().lower()
    return sign

# 全局配置
APP_KEY = "你的App Key"  # 替换为你的App Key
APP_SECRET = "你的App Secret"  # 替换为你的App Secret
API_URL = "http://gw.api.taobao.com/router/rest"  # 淘宝API网关地址（固定）

import requests
import time

def get_taobao_item(num_iid):
    # 1. 公共参数（所有接口必传）
    public_params = {
        "app_key": APP_KEY,
        "method": "taobao.item_get",  # 接口名称
        "format": "json",  # 响应格式
        "v": "2.0",  # API版本
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),  # 时间戳
        "sign_method": "md5"  # 签名方式
    }
    
    # 2. 业务参数（接口特定参数）
    business_params = {
        "num_iid": num_iid,  # 商品ID
        "fields": "num_iid,title,price,stock,sales,shop_name,category_name"  # 需返回的字段
    }
    
    # 3. 合并参数并生成签名
    all_params = {**public_params, **business_params}
    all_params["sign"] = generate_sign(all_params, APP_SECRET)  # 调用2.2中的签名函数
    
    # 4. 发送GET请求（淘宝API推荐GET方式）
    try:
        response = requests.get(API_URL, params=all_params, timeout=10)
        response.raise_for_status()  # 若状态码非200，抛出异常
        return response.json()  # 返回JSON格式响应
    except Exception as e:
        print(f"API调用失败：{str(e)}")
        return None

def parse_item_data(json_data):
    # 1. 判断请求是否成功（淘宝API通过"error_response"判断失败）
    if "error_response" in json_data:
        error_msg = json_data["error_response"]["msg"]
        print(f"请求失败：{error_msg}")
        return None
    
    # 2. 提取商品数据（成功响应的商品数据在"item_get_response"->"item"中）
    item_data = json_data["item_get_response"]["item"]
    
    # 3. 数据清洗与格式化（示例：转换价格为浮点型，销量为整型）
    parsed_data = {
        "商品ID": item_data["num_iid"],
        "商品标题": item_data["title"].strip(),  # 去除首尾空格
        "售价（元）": float(item_data["price"]),
        "库存（件）": int(item_data["stock"]),
        "销量（件）": int(item_data["sales"]),
        "店铺名称": item_data["shop_name"],
        "商品类目": item_data["category_name"]
    }
    
    return parsed_data

if __name__ == "__main__":
    # 示例：淘宝商品ID（可从商品详情页URL获取，如https://item.taobao.com/item.htm?id=123456789012）
    test_num_iid = "123456789012"
    
    # 1. 调用API获取数据
    json_response = get_taobao_item(test_num_iid)
    if not json_response:
        exit()
    
    # 2. 解析数据
    parsed_item = parse_item_data(json_response)
    if parsed_item:
        print("商品详情数据解析结果：")
        for key, value in parsed_item.items():
            print(f"{key}: {value}")

from bs4 import BeautifulSoup

def get_taobao_item_desc(num_iid):
    # 1. 构造参数（类似3.2，仅接口名称改为"taobao.item_get_desc"）
    public_params = {
        "app_key": APP_KEY,
        "method": "taobao.item_get_desc",
        "format": "json",
        "v": "2.0",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        "sign_method": "md5"
    }
    business_params = {"num_iid": num_iid}
    all_params = {**public_params, **business_params}
    all_params["sign"] = generate_sign(all_params, APP_SECRET)
    
    # 2. 调用API并解析HTML
    try:
        response = requests.get(API_URL, params=all_params, timeout=10)
        response.raise_for_status()
        desc_html = response.json()["item_get_desc_response"]["item"]["desc"]
        
        # 3. 提取纯文本（去除HTML标签）
        soup = BeautifulSoup(desc_html, "lxml")
        desc_text = soup.get_text().strip()
        return desc_text
    except Exception as e:
        print(f"详情描述获取失败：{str(e)}")
        return None

def get_taobao_item_sku(num_iid):
    # 1. 构造参数（接口名称改为"taobao.item_get_sku"）
    public_params = {
        "app_key": APP_KEY,
        "method": "taobao.item_get_sku",
        "format": "json",
        "v": "2.0",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        "sign_method": "md5"
    }
    business_params = {"num_iid": num_iid}
    all_params = {**public_params, **business_params}
    all_params["sign"] = generate_sign(all_params, APP_SECRET)
    
    # 2. 调用API并解析SKU
    try:
        response = requests.get(API_URL, params=all_params, timeout=10)
        response.raise_for_status()
        sku_list = response.json()["item_get_sku_response"]["item"]["skus"]["sku"]
        
        # 3. 整理SKU数据（按规格分组）
        parsed_sku = []
        for sku in sku_list:
            parsed_sku.append({
                "SKU ID": sku["sku_id"],
                "规格": sku["spec_json"],  # 规格JSON（如{"颜色":"红色","尺寸":"M"}）
                "价格（元）": float(sku["price"]),
                "库存（件）": int(sku["stock"])
            })
        return parsed_sku
    except Exception as e:
        print(f"SKU数据获取失败：{str(e)}")
        return None