API返回的数据结构包含哪些字段？

以上字段和结构是淘宝商品详情API返回值的主要组成部分，具体字段可能会根据API版本和请求参数有所不同。在实际开发中，建议仔细阅读淘宝开放平台的API文档，并根据需求选择合适的字段进行解析和处理。淘宝商品详情API返回的数据结构较为复杂，具体字段会根据API的版本和请求参数有所不同。：商品详情页HTML，可能包含广告和内链，需要进行过滤。：属性组合ID，需通过属性API转换为可读的属性描述。：商品

小爬虫程序猿

864人浏览 · 2025-02-24 15:11:24

小爬虫程序猿 · 2025-02-24 15:11:24 发布

淘宝商品详情API返回的数据结构较为复杂，具体字段会根据API的版本和请求参数有所不同。以下是基于最新搜索结果的API返回值字段说明：

基础字段

num_iid：商品的唯一标识ID。
title：商品标题，用于描述商品名称或特点。
price：商品的当前销售价格。
final_price：实际成交价，可能与price不同。
desc：商品详细描述，通常包含HTML格式的文本。
item_imgs：商品图片链接，可能包含多张图片。
props：商品属性列表，如品牌、材质等。
sku：商品的库存单位，用于区分不同规格或颜色。
stock：商品库存数量。
sales：商品销量。
createdAt：商品创建时间。
updatedAt：商品更新时间。

SKU字段

sku_id：SKU的唯一ID。
properties：属性组合ID，需通过属性API转换为可读的属性描述。
quantity：SKU的库存数量。
price：SKU的价格。
specs：规格可视化描述，如颜色、尺码。

详情页HTML处理

desc：商品详情页HTML，可能包含广告和内链，需要进行过滤。
图片防盗链：需要替换图片的src为自建CDN代理。
简化结构：可以使用正则表达式或HTML解析工具提取纯文本和关键图片。

其他字段

category：商品所属分类。
brand：商品品牌名称。
nick：卖家昵称。
detail_url：商品详情页面链接。

返回状态字段

status：请求状态码，0表示成功，非0表示失败。
message：请求失败时的错误信息。

返回数据结构示例

{
  "item": {
    "num_iid": "633123456789",
    "title": "2023新款夏季男士短袖T恤",
    "price": "89.00",
    "final_price": "59.00",
    "desc": "<html>商品详情描述...</html>",
    "item_imgs": [
      {"url": "https://img.alicdn.com/imgextra/i1/123/O1CN01abcd...jpg"}
    ],
    "props": [
      {"name": "品牌", "value": "XX品牌"},
      {"name": "材质", "value": "纯棉"}
    ],
    "sku": {
      "sku": [
        {
          "sku_id": "123456789",
          "properties": "1627207:28332;",
          "quantity": 100,
          "price": "59.00",
          "specs": [
            {"name": "颜色", "value": "白色"},
            {"name": "尺码", "value": "L"}
          ]
        }
      ]
    }
  }
}

以上字段和结构是淘宝商品详情API返回值的主要组成部分，具体字段可能会根据API版本和请求参数有所不同。在实际开发中，建议仔细阅读淘宝开放平台的API文档，并根据需求选择合适的字段进行解析和处理。