淘宝商品详情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
:请求失败时的错误信息。
返回数据结构示例
java">{
"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文档,并根据需求选择合适的字段进行解析和处理。