淘宝商品详情 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-python from 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
商品评论数据