淘宝/天猫商品描述API（taobao.item_get_desc）返回值全面解析

curl -i "https://api-gw.onebound.cn/taobao/item_get_desc/?key=<your_api_key>&secret=<your_api_secret>&num_iid=520813250866"

{
    "request_id": "4f8c9d2e1a3b5f6e7d8c9b0a1f2e3d4c",
    "item": {
        "num_iid": "520813250866",
        "title": "2024新款夏季纯棉短袖T恤男女宽松百搭上衣",
        "price": "59.90",
        "desc": "<div class='detail-content'>...</div>",
        "desc_images": [...],
        "detail_url": "https://item.taobao.com/item.htm?id=520813250866",
        "shop_info": {...}
    },
    "error_response": null}

<div class="detail-content">
    <div class="detail-item">
        <h3>商品详情</h3>
        <p>精选100%纯棉面料，透气舒适...</p>
        <img src="//img.alicdn.com/imgextra/i1/xxx.jpg" />
    </div>
    <div class="detail-params">
        <table>
            <tr><th>品牌</th><td>XX服饰</td></tr>
            <tr><th>材质</th><td>100%棉</td></tr>
            <tr><th>尺码</th><td>S/M/L/XL/XXL</td></tr>
        </table>
    </div></div>

"desc_images": [
    {
        "url": "https://img.alicdn.com/imgextra/i1/2688/TB2abc123.jpg",
        "position": 1,
        "width": 750,
        "height": 800
    },
    {
        "url": "https://img.alicdn.com/imgextra/i2/2688/TB2def456.jpg", 
        "position": 2,
        "width": 750,
        "height": 800
    }]

"skus": {
    "sku": [
        {
            "sku_id": "123456",
            "properties": "1627207:28341;20509:28314",
            "properties_name": "颜色:白色;尺码:M",
            "price": "59.90",
            "stock": 320,
            "outer_id": "SKU-001"
        }
    ]}

{
    "error_response": {
        "code": 40,
        "msg": "Insufficient isv permissions",
        "sub_code": "isv.permission-ip-whitelist-limit",
        "sub_msg": "IP白名单限制"
    }}

import refrom bs4 import BeautifulSoupdef process_desc_html(html_content):
    """处理商品描述HTML"""
    soup = BeautifulSoup(html_content, 'html.parser')
    
    # 1. 移除script标签（安全风险）
    for script in soup.find_all('script'):
        script.decompose()
    
    # 2. 处理图片防盗链
    for img in soup.find_all('img'):
        original_src = img.get('src', '')
        if original_src.startswith('//'):
            img['src'] = 'https:' + original_src        # 可添加图片懒加载属性
        img['loading'] = 'lazy'
    
    # 3. 移除淘宝内链广告
    for a in soup.find_all('a'):
        if 'click.taobao.com' in a.get('href', ''):
            a.unwrap()  # 移除链接保留文本
    
    # 4. 提取纯文本（用于搜索索引）
    text_content = soup.get_text(separator='\n', strip=True)
    
    return {
        'safe_html': str(soup),
        'text_content': text_content,
        'image_count': len(soup.find_all('img'))
    }

import requestsimport timeimport hashlibdef get_item_desc(app_key, app_secret, num_iid):
    """
    获取淘宝商品描述信息
    """
    url = "https://api-gw.onebound.cn/taobao/item_get_desc/"
    
    # 构造请求参数
    params = {
        'key': app_key,
        'secret': app_secret,
        'num_iid': num_iid,
        'cache': 'yes',
        'result_type': 'json',
        'lang': 'cn'
    }
    
    try:
        response = requests.get(url, params=params, timeout=10)
        response.raise_for_status()
        
        data = response.json()
        
        # 检查错误
        if data.get('error_response'):
            error = data['error_response']
            print(f"API错误: {error.get('msg')}")
            return None
            
        item = data.get('item', {})
        
        # 提取核心数据
        result = {
            'item_id': item.get('num_iid'),
            'title': item.get('title'),
            'price': float(item.get('price', 0)),
            'description_html': item.get('desc'),
            'detail_url': item.get('detail_url'),
            'shop_name': item.get('shop_info', {}).get('shop_name'),
            'request_id': data.get('request_id')
        }
        
        return result        
    except requests.exceptions.RequestException as e:
        print(f"请求异常: {e}")
        return None# 使用示例if __name__ == "__main__":
    item_data = get_item_desc(
        app_key="your_app_key",
        app_secret="your_app_secret", 
        num_iid="520813250866"
    )
    
    if item_data:
        print(f"商品标题: {item_data['title']}")
        print(f"商品价格: ¥{item_data['price']}")
        print(f"描述长度: {len(item_data['description_html'])} 字符")