淘宝商品详情API接口详解及Python请求示例（教学）

一、淘宝商品详情API接口概述

淘宝商品详情API接口是淘宝开放平台提供的一种编程接口，旨在帮助开发者通过编程方式获取淘宝平台上商品的详细信息。这些信息包括但不限于商品的标题、价格、库存、销量、评价、图片、品牌、属性等。借助这一接口，开发者可以构建出功能丰富的应用，如价格监控、商品比价、数据分析、推荐系统等，以满足商家和用户的多样化需求。

二、API接口调用步骤

1. 注册开放平台账号

首先，需要在平台注册一个开发者账号，并完成实名认证。

2. 创建应用并获取API密钥

登录开放平台后，创建一个应用以获取API密钥（App Key和App Secret）。这些密钥是调用API接口的身份凭证，需妥善保管。

3. 申请API权限

在应用管理页面申请taobao.item.get（商品详情接口）权限。部分高级接口可能需要提交业务场景说明，审核通过后方可使用。

4. 构造请求并发送

使用编程语言（如Python）的HTTP库（如requests）构造请求，并发送至淘宝API接口。请求中需要包含必要的参数，如App Key、商品ID、时间戳、签名等。

5. 解析响应数据

API接口返回的数据通常为JSON格式，需要使用合适的工具或库（如Python的json库）进行解析，以提取所需的商品信息。

三、Python请求示例

以下是一个使用Python调用淘宝商品详情API接口的示例代码：

	import hashlib
	import hmac
	import time
	import urllib.parse
	import requests
	# 淘宝开放平台相关配置
	APP_KEY = 'your_app_key' # 替换为你的App Key
	APP_SECRET = 'your_app_secret' # 替换为你的App Secret
	ITEM_ID = '123456789' # 替换为你想获取详情的商品ID
	# 当前时间戳（毫秒）
	TIMESTAMP = str(round(time.time() * 1000))
	# API接口URL
	API_URL = 'https://eco.taobao.com/router/rest'
	# 请求参数
	METHOD = 'taobao.item.get'
	FIELDS = 'num_iid,title,price,pic_url,skus' # 指定返回字段
	PARAMS = {
	'method': METHOD,
	'app_key': APP_KEY,
	'timestamp': TIMESTAMP,
	'v': '2.0', # API版本
	'format': 'json', # 返回格式
	'sign_method': 'hmac', # 签名算法
	'fields': FIELDS,
	'num_iid': ITEM_ID # 商品ID
	}
	# 生成签名
	def generate_sign(params, app_secret):
	sorted_params = sorted(params.items())
	sign_content = ''.join(f'{k}{v}' for k, v in sorted_params)
	sign_content = f'{sign_content}{app_secret}'
	sign = hmac.new(app_secret.encode('utf-8'), sign_content.encode('utf-8'), hashlib.md5).hexdigest().upper()
	return sign
	# 生成最终的请求参数，并添加签名
	SIGN = generate_sign(PARAMS, APP_SECRET)
	PARAMS['sign'] = SIGN
	# 发送HTTP GET请求
	response = requests.get(API_URL, params=PARAMS)
	# 处理响应
	if response.status_code == 200:
	data = response.json()
	if data['taobao_response'].get('code') == 200:
	item = data['taobao_response']['item']
	print(f"商品ID: {item['num_iid']}")
	print(f"商品标题: {item['title']}")
	print(f"商品价格: {item['price']}")
	print(f"商品图片链接: {item['pic_url']}")
	print(f"商品SKU信息: {item['skus']}")
	else:
	print(f"API调用失败: {data['taobao_response']['msg']}")
	else:
	print(f"请求失败: {response.status_code}")

四、JSON返回数据示例

淘宝商品详情API接口返回的JSON数据通常包含以下字段：

	{
	"taobao_response": {
	"code": 200, // 返回码（200表示成功）
	"msg": "success", // 返回信息
	"request_id": "123e4567-e89b-12d3-a456-426614174001", // 唯一请求标识符
	"item_get_response": {
	"item": {
	"num_iid": "123456789", // 商品ID
	"title": "夏季新款男士短袖T恤圆领纯棉上衣", // 商品标题
	"price": "59.90", // 当前售价（单位：元）
	"original_price": "99.00", // 原价（如无促销则为空）
	"num": 100, // 库存数量（部分接口可能不返回）
	"detail_url": "https://item.taobao.com/item.htm?id=123456789", // 详情页链接
	"pic_url": [ // 商品主图URL列表
	"//img.alicdn.com/imgextra/i1/123456789/O1CN01abcd123456789_1.jpg",
	"//img.alicdn.com/imgextra/i1/123456789/O1CN01abcd123456789_2.jpg"
	],
	"desc": "<div>商品描述内容(可能包含HTML标签)...</div>", // 商品描述
	"props": [ // 商品属性列表
	{"name": "品牌", "value": "某品牌"},
	{"name": "颜色", "value": "白色"},
	{"name": "尺码", "value": "M/L/XL"}
	],
	"skus": { // SKU信息（不同规格的价格、库存等）
	"sku": [
	{
	"sku_id": "sku_1",
	"price": "59.90",
	"quantity": 50, // 库存
	"properties": "颜色:白色;尺码:M"
	},
	{
	"sku_id": "sku_2",
	"price": "59.90",
	"quantity": 30,
	"properties": "颜色:黑色;尺码:L"
	}
	]
	},
	"seller_info": { // 卖家信息
	"nick": "店铺名称", // 卖家昵称
	"shop_id": "987654321", // 店铺ID
	"shop_name": "某品牌旗舰店"
	},
	"coupon_info": { // 优惠券信息（如有）
	"amount": "10.00", // 优惠券金额
	"start_time": "2025-03-31 00:00:00", // 生效时间
	"end_time": "2025-04-30 23:59:59" // 失效时间
	},
	"promotions": [ // 促销活动（如有）
	{
	"type": "满减",
	"desc": "满100元减20元"
	}
	]
	}
	}
	}
	}

五、注意事项

1. API密钥管理：确保在请求中包含正确的API密钥和商品ID。
2. API响应处理：处理好API响应，通常响应数据为JSON格式，需要使用合适的工具或库进行解析。
3. API文档查阅：根据API文档，解析响应数据中的商品信息，并进行后续处理。
4. 频率限制：遵循淘宝开放平台的API调用频率限制，避免过度调用或滥用接口。
5. 数据隐私与安全：在传输和存储过程中采取必要的安全措施，保护用户隐私和敏感信息。