淘宝开放平台：商品详情API接口使用指南

​

 在电商系统开发、数据分析或比价工具等场景中，获取商品详情信息是基础且关键的需求。淘宝开放平台提供了丰富的API接口，其中获取商品详情信息是使用频率极高的接口之一。本文将详细介绍如何通过淘宝开放平台提供的API接口获取商品详情。

1. 接口概述

淘宝开放平台的商品详情API允许开发者通过商品ID（num_iid）查询商品的详细信息，包括但不限于：

商品标题

商品主图、详情图

商品类目ID

商品属性

商品价格

商品库存

商品描述

店铺信息

运费信息等

2. 接口调用流程

调用淘宝API获取商品详情通常遵循以下步骤：

2.1 申请成为淘宝开放平台开发者

访问淘宝开放平台官网（open.taobao.com），注册账号并完成开发者认证。

2.2 创建应用

登录开放平台控制台，创建一个新应用。创建过程中，需要为应用选择合适的权限，获取商品详情通常属于商品类API权限。

2.3 获取API调用凭证

应用创建成功后，系统会分配一对密钥：

App Key：应用的唯一标识。

App Secret：用于签名验证的密钥，务必保密。 同时，你需要获取Access Token（访问令牌），这通常需要通过OAuth2.0授权流程获得。

2.4 调用商品详情API

准备好以下信息后，即可发起API请求：

API地址：通常是 https://eco.taobao.com/router/rest。

API方法名：例如 taobao.item.get。

请求参数：必须包含app_key、access_token、sign（签名）、timestamp（时间戳）、v（API版本号）等公共参数，以及业务参数num_iid（商品ID）。

签名：根据请求参数和App Secret，按照淘宝指定的签名算法（如HMAC-SHA256）生成签名串sign，用于验证请求的合法性。

3. 核心参数说明

num_iid: 要查询的淘宝商品ID。这是一个必需的业务参数。例如：1234567890。

fields: 可选参数。指定需要返回的商品信息字段，多个字段用逗号分隔。如果不指定，默认返回所有基础字段。例如：title,price,pic_url 表示只获取标题、价格和主图链接。

4. 请求示例

以下是一个Python代码示例（使用requests库），展示如何构造请求（注意：App Secret 和 Access Token 需要替换为你的实际值）：

 

import hashlib
import hmac
import time
import requests

def get_taobao_item_detail(num_iid, app_key, app_secret, access_token):
    # 1. 公共参数
    timestamp = str(int(time.time() * 1000))  # 毫秒时间戳
    method = 'taobao.item.get'  # API方法名
    v = '2.0'  # API版本
    format = 'json'  # 响应格式

    # 2. 业务参数
    params = {
        'method': method,
        'app_key': app_key,
        'timestamp': timestamp,
        'v': v,
        'format': format,
        'sign_method': 'hmac-sha256',
        'access_token': access_token,
        'num_iid': num_iid,
        'fields': 'title,price,pic_url,desc'  # 按需选择字段
    }

    # 3. 参数排序并拼接
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = app_secret
    for key, value in sorted_params:
        param_str += key + value
    param_str += app_secret

    # 4. 计算签名 (HMAC-SHA256)
    sign = hmac.new(app_secret.encode('utf-8'), param_str.encode('utf-8'), hashlib.sha256).hexdigest().upper()
    params['sign'] = sign

    # 5. 发送请求
    response = requests.get('https://eco.taobao.com/router/rest', params=params)
    return response.json()

# 使用示例
app_key = 'YOUR_APP_KEY'
app_secret = 'YOUR_APP_SECRET'  # 注意安全保管
access_token = 'YOUR_ACCESS_TOKEN'
num_iid = '1234567890'  # 目标商品ID

result = get_taobao_item_detail(num_iid, app_key, app_secret, access_token)
print(result)

 

5. 响应解析

成功的API调用将返回一个JSON对象。核心数据结构通常包含在response下的item对象中。例如：

 

{
  "item_get_response": {
    "item": {
      "title": "【官方正品】XX品牌 新款智能手机 全网通5G",
      "price": "2999.00",
      "pic_url": "https://img.alicdn.com/.../main.jpg",
      "desc": "< p >这里是商品描述详情页的HTML内容...< /p >"
      // ... 其他请求的字段
    }
  }
}

 

你需要根据业务需求解析这个JSON结构中的具体字段值。注意desc字段通常是HTML格式的商品详情描述。

6. 注意事项

权限与频率限制：确保你的应用已申请并获得了调用商品详情API的权限。淘宝API有严格的调用频率限制（QPS），超出限制会导致调用失败。

安全：App Secret 是核心机密，切勿泄露或在客户端代码中硬编码。

商品ID有效性：确保传入的num_iid是有效的淘宝商品ID。

错误处理：API响应中可能包含错误码（如error_code和error_msg），需要做好异常捕获和处理。常见错误如无效令牌、参数缺失、频率超限等。

数据更新：商品详情（如价格、库存）可能会频繁变动，注意数据的时效性。

7. 总结

通过淘宝开放平台的taobao.item.get接口，开发者可以高效、规范地获取淘宝商品的详细信息。关键在于正确理解API调用流程、签名机制以及参数传递方式。在实际应用中，务必遵守淘宝开放平台的规则，合理使用API资源。

​
审核编辑 黄宇