淘宝API商品详情接口最新版，Json数据格式参考

桃色几许.

2404人浏览 · 2025-06-09 18:02:00

桃色几许. · 2025-06-09 18:02:00 发布

淘宝商品详情API接口是开发者获取淘宝平台商品数据的重要途径，2025年最新版本提供了更丰富的数据字段和更高效的调用方式。以下是淘宝商品详情接口的详细介绍及JSON数据格式参考。

一、接口概述

淘宝开放平台提供了多个商品详情API接口，主要包括：

taobao.item.get：获取淘宝商品详情
tmall.item.get：获取天猫商品详情
taobao.item.get.pro：增强版商品详情接口（支持更多字段）9

这些接口可以获取商品的基础信息、价格、库存、SKU规格、描述、评价等全方位数据，为电商数据分析、比价系统、智能选品等应用提供数据支持3。

二、接口调用流程

注册与认证
- 访问淘宝开放平台官网注册开发者账号
- 完成个人或企业实名认证
- 创建应用并获取App Key和App Secret35
申请接口权限
- 在应用管理界面申请商品详情数据接口调用权限
- 等待审核（通常1-3个工作日）3
构建请求
- 使用HTTP GET/POST方法调用接口
- 包含必要的认证参数和商品ID参数9
处理响应
- 解析返回的JSON格式数据
- 提取所需商品信息4

三、最新版JSON数据格式参考（2025年）

以下是淘宝商品详情API接口返回的JSON数据结构示例：

json

复制

下载

{
  "request_id": "your_unique_request_id",
  "code": 0,
  "msg": "success",
  "item": {
    "id": "123456789",
    "title": "2025新款智能手表旗舰版",
    "price": "1299.00",
    "original_price": "1599.00",
    "nick": "官方旗舰店",
    "shop_id": "987654321",
    "shop_name": "XX品牌旗舰店",
    "desc": "<p>2025年最新款智能手表，支持健康监测、移动支付等功能...</p>",
    "detail_url": "https://item.taobao.com/item.htm?id=123456789",
    "main_image": "https://img.alicdn.com/xxx_main.jpg",
    "3d_model": "https://3dmodel.taobao.com/xxx.glb",
    "skus": [
      {
        "sku_id": "sku_001",
        "price": "1299.00",
        "original_price": "1599.00",
        "stock": 150,
        "sold_num": 350,
        "properties": "颜色:黑色;尺寸:标准版",
        "barcode": "6921234567890",
        "image": "https://img.alicdn.com/xxx_black.jpg"
      },
      {
        "sku_id": "sku_002",
        "price": "1399.00",
        "original_price": "1699.00",
        "stock": 80,
        "sold_num": 120,
        "properties": "颜色:银色;尺寸:Pro版",
        "barcode": "6921234567891",
        "image": "https://img.alicdn.com/xxx_silver.jpg"
      }
    ],
    "images": [
      "https://img.alicdn.com/xxx_1.jpg",
      "https://img.alicdn.com/xxx_2.jpg",
      "https://img.alicdn.com/xxx_3.jpg"
    ],
    "properties": [
      {
        "name": "品牌",
        "value": "XX品牌"
      },
      {
        "name": "型号",
        "value": "Watch 2025"
      },
      {
        "name": "材质",
        "value": "钛金属表壳"
      }
    ],
    "coupon_info": {
      "amount": "100.00",
      "condition": "满1000元可用",
      "start_time": "2025-06-01 00:00:00",
      "end_time": "2025-06-30 23:59:59"
    },
    "promotions": [
      {
        "type": "满减",
        "desc": "满1000减100",
        "start_time": "2025-06-01",
        "end_time": "2025-06-30"
      },
      {
        "type": "赠品",
        "desc": "购买即赠原装表带一条"
      }
    ],
    "logistics": {
      "post_fee": "0.00",
      "express_fee": "0.00",
      "ems_fee": "15.00",
      "is_free": true,
      "delivery_time": "48小时内发货"
    },
    "rate_info": {
      "total_count": 1250,
      "good_count": 1220,
      "good_rate": "97.6%",
      "average_score": "4.8"
    },
    "realtime_data": {
      "view_count": 12500,
      "favorite_count": 680,
      "cart_count": 320,
      "conversion_rate": "2.56%"
    },
    "service_guarantees": [
      "七天无理由退换",
      "正品保证",
      "全国联保"
    ],
    "activity_info": {
      "presale": false,
      "groupbuy": true,
      "groupbuy_price": "1199.00",
      "groupbuy_user_count": 25
    },
    "create_time": "2025-01-15 10:30:45",
    "update_time": "2025-06-05 14:20:30",
    "is_on_sale": 1,
    "global_info": {
      "is_oversea": false,
      "tax_info": {
        "tax_rate": "13%",
        "tax_type": "增值税"
      }
    }
  }
}

四、核心字段说明

1. 基础信息字段

字段名	类型	说明
id	String	商品唯一ID
title	String	商品标题
price	String	当前售价
original_price	String	商品原价
nick	String	卖家昵称
shop_id	String	店铺ID
shop_name	String	店铺名称
desc	String	商品描述(HTML格式)
detail_url	String	商品详情页URL
main_image	String	商品主图URL
3d_model	String	商品3D模型URL(如有)

2. SKU信息

字段名	类型	说明
skus	Array	SKU列表
- sku_id	String	SKU唯一ID
- price	String	SKU价格
- original_price	String	SKU原价
- stock	Number	SKU库存
- sold_num	Number	SKU销量
- properties	String	SKU属性(如"颜色:红色;尺码:L")
- barcode	String	SKU条形码
- image	String	SKU图片

3. 促销与活动信息

字段名	类型	说明
coupon_info	Object	优惠券信息
- amount	String	优惠券面额
- condition	String	使用条件
- start/end_time	String	有效期
promotions	Array	促销活动列表
- type	String	活动类型(满减/赠品等)
- desc	String	活动描述
activity_info	Object	活动信息
- presale	Boolean	是否预售
- groupbuy	Boolean	是否团购
- groupbuy_price	String	团购价
- groupbuy_user_count	Number	参团人数

4. 其他重要字段

字段名	类型	说明
rate_info	Object	评价信息
- total_count	Number	评价总数
- good_rate	String	好评率
realtime_data	Object	实时数据
- view_count	Number	浏览量
- conversion_rate	String	转化率
logistics	Object	物流信息
- post_fee	String	平邮费用
- is_free	Boolean	是否包邮
global_info	Object	跨境信息
- is_oversea	Boolean	是否海外商品
- tax_info	Object	税费信息

五、接口调用注意事项

权限与认证
- 必须使用有效的App Key和App Secret
- 需要生成正确的签名(sign)3
- 部分高敏感字段需要额外申请权限9
调用限制
- 单个应用每日调用量限制(通常万次级别)
- 频率限制(如每秒不超过50次)6
- 敏感字段有特殊调用限制1
数据使用规范
- 不得缓存数据超过15分钟(价格/库存等实时数据)6
- 不得将数据用于非法用途
- 遵守淘宝数据安全与隐私保护规定1
错误处理
- 检查返回的code字段(0表示成功)
- 常见错误码：
  - 1001：参数错误
  - 1002：商品不存在
  - 2001：系统错误
  - 3001：访问令牌无效2

六、Python调用示例

python

复制

下载

import requests
import hashlib
import time
import json

# 配置参数
app_key = 'your_app_key'
app_secret = 'your_app_secret'
item_id = '123456789'  # 商品ID

# 生成签名
def generate_sign(params):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    base_str = app_secret + ''.join([f'{k}{v}' for k, v in sorted_params]) + app_secret
    return hashlib.md5(base_str.encode()).hexdigest().upper()

# 获取商品详情
def get_item_detail(item_id):
    timestamp = str(int(time.time()))
    params = {
        'method': 'taobao.item.get',
        'app_key': app_key,
        'timestamp': timestamp,
        'format': 'json',
        'v': '2.0',
        'sign_method': 'md5',
        'item_id': item_id,
        'fields': 'id,title,price,skus,images,properties,coupon_info'
    }
    params['sign'] = generate_sign(params)
    
    try:
        response = requests.get('https://eco.taobao.com/router/rest', params=params)
        result = response.json()
        
        if 'error_response' in result:
            print(f"错误: {result['error_response']['msg']}")
            return None
        
        return result.get('item_get_response', {}).get('item')
    except Exception as e:
        print(f"请求失败: {str(e)}")
        return None

# 调用示例
item_data = get_item_detail(item_id)
if item_data:
    print(json.dumps(item_data, indent=2, ensure_ascii=False))