淘宝/天猫商品详情查询API接口调用说明(item_detail)

商品基本信息：包括商品标题、类目、商品参数、评论数等。主图与视频：获取商品的主图和视频资源。店铺信息：涵盖店铺名称、ID、链接。物流信息：提供发货地、邮费等物流相关信息。SKU属性：包括SKU名称、缩略图、价格（含到手价、原价）、库存等。商品图片与规格参数：支持获取商品图片及详细规格参数。

openapi20208

1014人浏览 · 2025-05-06 20:04:20

openapi20208 · 2025-05-06 20:04:20 发布

淘宝详情API接口是淘宝开放平台为开发者提供的一项关键服务，旨在帮助开发者高效获取商品的详细信息。通过这一接口，开发者能够轻松访问淘宝平台上的丰富商品数据，从而为各类应用提供强大的数据支持。

1. 接口功能概述

1.1 接口能力

淘宝详情API接口提供了以下核心功能：

商品基本信息：包括商品标题、类目、商品参数、评论数等。
主图与视频：获取商品的主图和视频资源。
店铺信息：涵盖店铺名称、ID、链接。
物流信息：提供发货地、邮费等物流相关信息。
SKU属性：包括SKU名称、缩略图、价格（含到手价、原价）、库存等。
商品图片与规格参数：支持获取商品图片及详细规格参数。

1.2 应用场景

该接口适用于多种业务场景，包括但不限于：

商品价格监控：实时查询热销商品的SKU价格及竞品市场价格。
促销活动分析：获取商品的促销信息，帮助优化营销策略。
数据洞察与市场分析：通过商品销售表现数据，进行市场趋势分析。
ERP选品与上货：为代购商城、ERP系统提供商品数据支持。
广告投放优化：基于商品数据优化广告投放策略。

2. 使用流程

2.1 获取请求参数

调用淘宝详情API接口时，需提供以下参数：

参数名称	类型	是否必填	描述
item_id	String	是	商品ID
token	String	是	API接口密钥

2.2 接口调用

开发者可通过GET或POST方式调用接口，具体步骤如下：

构造请求URL：将API密钥（appKey和appSecret）与请求参数（如商品ID）拼接成完整的URL。
发送请求：通过HTTP GET请求发送构造好的URL。
获取响应：接口将返回对应商品的详细数据。

请求示例：

import http.client

conn = http.client.HTTPSConnection("APIip", 5001)
payload = ''
headers = {}
conn.request("GET", "/tb/new/item_detail?token=&item_id=583744037606", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

3. 响应示例

接口调用成功后，将返回包含商品详细信息的JSON格式数据。开发者可根据业务需求解析并利用这些数据。

{
  "code": 200,
  "total_remaining": "25.000",
  "data": {
    "id": "718675380206",
    "is_sku": true,
    "itemType": "淘宝",
    "price": "670.00",
    "promotion": [
      {
        "content": "店铺满折",
        "sub_content": "店铺满1件7折",
        "start_time": "",
        "end_time": "",
        "type": "discount"
      }
    ],
    "sale": "",
    "commentCount": "",
    "category_id": "50012131",
    "category_path": "汽车零部件/养护/美容/维保->轮胎->乘用车轮胎",
    "pic_urls": [
      "https://img.alicdn.com/bao/uploaded/i1/2207483581832/O1CN01YkD6HQ1PP6dVeU7Uk_!!4611686018427385224-0-item_pic.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/2207483581832/O1CN01axEuuc1PP6XCcahn0_!!2207483581832.jpg",
      "https://img.alicdn.com/bao/uploaded/i4/2207483581832/O1CN01MeclHF1PP6X1o41co_!!2207483581832.jpg",
      "https://img.alicdn.com/bao/uploaded/i3/2207483581832/O1CN01ECHUiR1PP6dQuxzG8_!!2207483581832.jpg",
      "https://img.alicdn.com/bao/uploaded/i3/2207483581832/O1CN01SlTZjy1PP6ZpE79Iy_!!2207483581832.jpg"
    ],
    "skus": [
      {
        "picUrl": "",
        "id": "5187112947623",
        "name": "轮胎类型:普通胎;销售版本:黑色",
        "price": "670.00",
        "subPrice": "469.00",
        "subPriceTitle": "折后",
        "quantity": "200"
      }
    ],
    "state": "上架",
    "timestamp": "2025-05-06 19:59:47",
    "title": "***轮胎 195/60R16 89H ENASAVE EC300+ 原配轩逸骐达蓝鸟",
    "desc_urls": [
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01cuzR3G1PP6Z16bGyA_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01DaKoUe1PP6XVGxbyp_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN012KQISv1PP6dX7ZA1o_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN013aoF4I1PP6dZdBx89_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN01BVPAll1PP6dXLjtGo_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN01ul7bPd1PP6dXu5GIN_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN014DPio81PP6dY7MsXB_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01bcHek31PP6dXW40rD_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN01JBmaCs1PP6dWCDNKC_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01zlo60l1PP6XNkQ4tK_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN018yu7rg1PP6dYhXhno_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01ISttRt1PP6dVT2WLx_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN01WotrZ01PP6dVT1FM9_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01quq3oL1PP6dXzcEWZ_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01zb9FCV1PP6dWCCltr_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN014gumvw1PP6dRAeOLO_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01xLsxZX1PP6XW3QLsh_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN01kglOxc1PP6XTcSWw9_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN01NnBEpa1PP6dY7Op6x_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01PHts1z1PP6dX7Kvdk_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN012Smt7c1PP6XVPbsUl_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN01qgnkO71PP6dRAffLo_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN018Xzyy21PP6dZENZ0h_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01gYlKWK1PP6XYPPNbo_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01PUHGOr1PP6XcuhLuW_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN01ILthLI1PP6dYhVYkp_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN01Z5LIs01PP6dY7Mwh0_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN011ZxRRi1PP6dW55E8H_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01tAHwbY1PP6dVT02WE_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01R9jNsF1PP6XWsnDZt_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i4/2207483581832/O1CN019HvMy51PP6dW56Mos_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN01ALHPT41PP6dXW1CD5_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i2/2207483581832/O1CN01MFHuY81PP6XTcUfzZ_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN01xyspAt1PP6XXTvObY_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i1/2207483581832/O1CN015jlIfT1PP6dXLjUK3_!!2207483581832.jpg",
      "https://img.alicdn.com/imgextra/i3/2207483581832/O1CN01oOJ5yy1PP6dX7KjAP_!!2207483581832.jpg"
    ],
    "shopName": "***店",
    "shopId": ***772,
    "nick": "***店",
    "sellerId": ***832,
    "postage": 0,
    "from": "云南昆明",
    "props": [
      {
        "name": "品牌",
        "value": "Dunlop/邓禄普"
      },
      {
        "name": "花纹",
        "value": "ENASAVE EC300+"
      },
      {
        "name": "产地",
        "value": "中国大陆"
      },
      {
        "name": "销售版本",
        "value": "黑色"
      },
      {
        "name": "轮胎规格",
        "value": "195/60R16"
      },
      {
        "name": "负荷指数",
        "value": "89"
      },
      {
        "name": "轮辋直径",
        "value": "16英寸"
      },
      {
        "name": "胎面宽度",
        "value": "195mm"
      },
      {
        "name": "速度级别",
        "value": "H"
      },
      {
        "name": "条数",
        "value": "1条"
      },
      {
        "name": "扁平比",
        "value": "60%"
      },
      {
        "name": "轮胎类型",
        "value": "普通胎"
      },
      {
        "name": "花纹性能",
        "value": "运动操控型"
      }
    ]
  }
}

通过淘宝详情API接口，开发者能够快速获取商品的全面信息，从而为各类应用提供强大的数据支持。无论是价格监控、市场分析，还是广告优化，该接口都能帮助开发者提升业务效率，降低人力成本，增强市场竞争力。

在使用过程中，开发者需要遵守相关规定和协议，确保数据的安全和准确性。