技术实战：淘宝商品详情接口技术解析与标准JSON返回参考
前言
淘宝开放平台（TOP, Taobao Open Platform）的商品详情接口（taobao.item.get）是电商ERP、选品工具、多平台同步系统最核心的基础接口之一。该接口能够实时获取淘宝/天猫商品的标题、价格、库存、SKU规格、详情描述、图片资源等全维度结构化数据，是打通淘宝生态与自有业务系统的必备技术入口。
一、接口核心基础信息
表格
项目 | 说明 |
接口名称 | 获取商品详情 (taobao.item.get) |
请求协议 | HTTPS POST / GET |
数据格式 | JSON (推荐) 或 XML |
网关地址 | o0b.cn/anzexi |
鉴权方式 | AppKey + AppSecret + SessionKey (OAuth2.0) + Sign签名 |
适用场景 | 商品数据同步、价格监控、库存校验、详情页重构、选品分析 |
二、核心请求参数解析
调用淘宝API需严格遵循TOP签名规范，所有公共参数和业务参数均需参与签名计算。
1. 公共必选参数
表格
参数名 | 类型 | 必填 | 描述 |
app_key | String | 是 | 应用AppKey，在淘宝开放平台创建应用后获取 |
method | String | 是 | API接口名称，固定为 taobao.item.get |
session | String | 是 | 用户授权SessionKey，代表当前操作者的身份权限 |
timestamp | String | 是 | 时间戳，格式为 yyyy-MM-dd HH:mm:ss，时区为东八区 |
v | String | 是 | API协议版本，通常为 2.0 |
sign_method | String | 是 | 签名算法，推荐 hmac-sha256 |
sign | String | 是 | 签名值，由AppSecret对参数排序拼接后加密生成 |
format | String | 否 | 返回格式，默认为 json |
2. 业务请求参数
表格
参数名 | 类型 | 必填 | 描述 |
num_iid | Long | 是 | 商品数字ID（Item ID），即淘宝商品详情页URL中的id参数 |
fields | String | 是 | 需要返回的字段集合，如 num_iid,title,price,sku。按需指定可大幅提升接口响应速度 |
三、标准JSON返回参考示例
以下是基于淘宝开放平台官方规范整理的标准成功响应结构，完全匹配淘宝原生接口的返回逻辑，核心字段标注了业务含义，可直接用于开发调试参考：
{
"taobao_item_get_response": {
"code": 0,
"msg": "success",
"request_id": "tb_req_20260916172245987",
"item": {
"num_iid": 1003783113480,
"title": "Apple iPhone 16 Pro 256GB 钛金属 移动联通电信5G 双卡双待手机",
"nick": "Apple产品天猫官方旗舰店",
"cid": 50012079,
"outer_id": "APPLE-IP16PRO-256-TI",
"approve_status": "onsale",
"num": 12600,
"price": "8999.00",
"list_time": "2026-09-10 10:00:00",
"delist_time": "",
"desc": "<p>全新钛金属设计，A18 Pro芯片，超强性能体验...</p>",
"pic_url": "https://gd-hbimg.alicdn.com/imgextra/i1/O1CN01kLqZ7L1zqKzqKzqKz_!!6000000007239-2-tps-800-800.jpg",
"num_iid_str": "1003783113480",
"sku": {
"sku": [
{
"sku_id": 4567890123456,
"properties": "1627207:28349;1627209:28351",
"properties_name": "颜色:原色钛金属;内存:256GB",
"price": "8999.00",
"outer_id": "SKU-001",
"quantity": 3200
},
{
"sku_id": 4567890123457,
"properties": "1627207:28350;1627209:28351",
"properties_name": "颜色:白色钛金属;内存:256GB",
"price": "8999.00",
"outer_id": "SKU-002",
"quantity": 2800
}
]
},
"cid_path": "50012079,50012080,50012081",
"is_tmall": true,
"post_fee": "0.00",
"express_fee": "0.00",
"ems_fee": "0.00",
"has_discount": true,
"video": [
{
"url": "https://cloud.video.taobao.com/play/u/123456/p/1/e/6/t/1/987654321.mp4"
}
],
"item_imgs": {
"item_img": [
{"url": "https://img.alicdn.com/imgextra/i1/1.jpg"},
{"url": "https://img.alicdn.com/imgextra/i2/2.jpg"},
{"url": "https://img.alicdn.com/imgextra/i3/3.jpg"}
]
}
}
}
}