一、引言
天猫商品详情API(tmall.item_get)是天猫开放平台提供的核心服务接口,通过商品ID可获取商品标题、价格、库存、图片、SKU及评价等完整信息。该接口采用HTTP请求与JSON返回格式,广泛应用于电商数据分析、竞品监控、价格策略优化等场景12。随着电商多平台运营成为趋势,API对接已成为商家数据管理的标配解决方案。
二、接口概述
- 核心功能
商品基础信息:包含标题、类目、品牌、型号等关键属性。
价格体系:支持获取当前售价、原价及促销价等多维度价格数据。
库存管理:实时返回商品库存数量及SKU库存分布。
多媒体资源:提供主图、详情图等图片链接及视频资源。
SKU详情:包含规格属性、对应价格库存等结构化数据。
评价数据:返回商品评分及评价数量等口碑指标。 - 技术特性
请求方式:支持HTTP GET/POST两种请求方法。
数据格式:返回标准JSON格式数据,便于解析处理。
三、Python代码示例
以下是使用Python调用天猫商品详情API的完整实现方案:
```
import requests
import hashlib
import time
import urllib.parse
配置参数
api url:c0b.cc/R4rbK2 wechatid:Taobaoapi2014
def generate_sign(params, secret):
"""生成API签名"""
param_str = ''.join([f'{k}{v}' for k,v in sorted(params.items())])
return hashlib.md5((secret + param_str + secret).encode()).hexdigest()
def get_item_detail(item_id):
"""获取商品详情"""
params = {
'method': 'tmall.item.get',
'app_key': APP_KEY,
'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),
'format': 'json',
'v': '2.0',
'sign_method': 'md5',
'num_iid': item_id,
'fields': 'num_iid,title,price,pic_url,sku,desc,rate'
}
# 添加签名
params['sign'] = generate_sign(params, APP_SECRET)
try:
response = requests.get(API_URL, params=params)
if response.status_code == 200:
return response.json()
else:
print(f'请求失败,状态码:{response.status_code}')
except Exception as e:
print(f'API调用异常:{str(e)}')
示例调用
if name == 'main':
item_data = get_item_detail('商品ID') # 替换实际商品ID
print(item_data)
```
该实现包含签名生成、异常处理和完整字段请求,可获取商品基础信息、SKU数据和评价指标。