淘宝商品详情 API 是用于获取淘宝平台商品详细信息的接口,适用于开发者进行商品数据整合、电商应用开发、数据分析等场景。以下是详细的使用指南,涵盖从权限申请到接口调用的全流程:
一、API 使用前提:申请开发权限
1. 注册淘宝开放平台账号
- 访问 淘宝开放平台,注册账号并完成开发者认证(个人 / 企业开发者需根据要求提交资质)。认证通过后,创建应用(如 “商品详情查询工具”),用于获取 API 调用权限。
2. 申请 API 权限
- 在应用管理后台,找到 “商品管理” 或 “商品详情” 相关 API(如
taobao.item.get或taobao.tmall.item.get),提交权限申请。注意:部分 API 需通过审核(如涉及天猫商品需额外资质),审核周期通常为 1-3 个工作日。3. 获取开发密钥
- 申请通过后,在应用详情页获取
AppKey和AppSecret,这是调用 API 的必要凭证。二、开发准备:选择调用方式
1. 使用官方 SDK(推荐)
淘宝开放平台提供多种语言的 SDK(Java、Python、PHP 等),可简化签名和请求流程:
Python 示例(通过taobao-sdk-python库):
python
运行
# 安装SDK# pip install taobao-sdk-pythonfrom taobao.api import TaobaoClient# 初始化客户端client = TaobaoClient(appkey='你的AppKey', secret='你的AppSecret', format='json')# 调用商品详情接口(taobao.item.get)req = client.execute('taobao.item.get', { 'num_iid': '商品ID', # 必填参数:商品ID 'fields': 'num_iid,title,price,stock,pic_url,desc' # 需要返回的字段})# 处理返回结果print(req)2. 手动发送 HTTP 请求(适合熟悉 API 的开发者)
请求格式:
plaintext
POST https://gw.api.taobao.com/router/rest HTTP/1.1请求参数(需包含以下核心参数,并用 URL 编码):
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
app_key | string | 是 | 应用的 AppKey |
method | string | 是 | API 接口名称(如taobao.item.get) |
timestamp | string | 是 | 时间戳(格式:YYYY-MM-DD HH:MM:SS) |
format | string | 否 | 返回格式(默认json) |
v | string | 否 | API 版本(默认2.0) |
sign | string | 是 | 签名(需根据 AppSecret 和参数按官方规则生成) |
num_iid | long | 是 | 商品 ID(可从淘宝商品链接中获取,如https://item.taobao.com/item.htm?id=123456中的123456) |
fields | string | 否 | 需要返回的字段列表(用逗号分隔,如title,price,stock) |
三、接口调用核心参数详解
1. 必填参数(以taobao.item.get为例)
num_iid:商品 ID,唯一标识淘宝商品(获取方式:商品链接、淘宝 API 其他接口返回)。sign:签名参数,用于验证请求合法性,需按官方规则生成(签名算法示例可参考开放平台文档)。2. 可选参数(优化返回结果)
fields:指定返回的字段,避免获取冗余数据(如只需要价格和标题,可设置fields=title,price)。nick:卖家昵称,用于查询指定卖家的商品(需额外权限)。is_promise_sold:是否为承诺销售商品(布尔值,true/false)。四、响应数据解析
编辑
商品sku
编辑
商品评论数据
