技术实战：淘宝商品详情接口技术解析与标准JSON返回参考

原创

Anzexi58

发布于 2026-09-21 15:56:46

1020

前言

淘宝开放平台（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"}
        ]
      }
    }
  }
}

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

技术实战：淘宝商品详情接口技术解析与标准JSON返回参考

技术实战：淘宝商品详情接口技术解析与标准JSON返回参考

前言

一、接口核心基础信息

二、核心请求参数解析

1. 公共必选参数

2. 业务请求参数

三、标准JSON返回参考示例

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐