一、前言
淘宝商品详情 API 是获取商品核心信息的核心接口,可返回商品的标题、价格、主图、规格、库存、销量、店铺信息等关键数据。
二、接口概述
以最常用的taobao.item.get(获取单个商品详情)为例,核心信息如下:
2.1 基础信息
接口名称:taobao.item.get。
接口地址正式环境:c0b.cc/R4rbK2。
请求方式POST(推荐)/ GET。
数据格式请求:键值对 返回:JSON/XML(推荐 JSON)。
2.2 核心请求参数
app_key是字符串阿里开放平台创建应用后分配的 AppKey
timestamp是字符串时间戳,格式为 YYYY-MM-DD HH:MM:SS(如 2026-01-09 10:30:00)
v是字符串接口版本,固定为 2.0
sign是字符串接口签名(基于 AppSecret 的 MD5 加密,阿里标准算法)
sign_method是字符串签名方法,固定为 md5
num_iid是字符串商品 ID(淘宝商品详情页 URL 中id=后的数字,如1234567890)
fields是字符串需要返回的字段列表,多个字段用逗号分隔。推荐字段:num_iid,title,price,pic_url,item_imgs,stock,sales,shop_name,detail_url
- 3常见响应码
响应码说明解决方案
200调用成功正常解析返回数据
401权限不足检查是否已申请该接口权限,应用是否审核通过
403签名错误核对 AppSecret、参数排序、时间戳格式
404商品不存在检查商品 ID(num_iid)是否正确
500服务器内部错误稍后重试,或提交工单给阿里开放平台