淘宝/天猫商品详情API返回值全解析

淘宝/天猫的商品详情API返回值通常包含了丰富的商品信息，这些信息对于商家进行商品展示、库存管理、价格监控以及用户行为分析等方面都至关重要。然而，需要注意的是，淘宝/天猫的API接口是受到保护的，并且具体的返回值字段可能会随着API版本的变化而有所调整。因此，以下提供的解析是基于一般电商API的通用性和可能的返回值字段进行的说明，实际使用时请参考淘宝/天猫的官方API文档。

淘宝/天猫商品详情API返回值全解析

1. 商品基本信息

• 商品ID：唯一标识商品的编号。
• 商品标题：商品的名称。
• 商品图片URL：商品的图片链接，可能包含多张图片。
• 商品价格：商品的当前价格，可能包括原价和促销价。
• 商品库存：商品的库存数量，但某些情况下可能不返回具体数量。
• 商品SKU信息：如果商品有多个SKU（Stock Keeping Unit，库存量单位），则包含每个SKU的详细信息，如颜色、尺码、价格等。

taobao.item_get

公共参数

请求地址: https://api-gw.onebound.cn/taobao/item_get

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=652874751412&is_promotion=1

参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价

响应参数

Version: Date:2022-04-04

名称	类型	必须	示例值	描述
item	item[]	1		宝贝详情数据

 

2. 商品详细描述

• 商品详情描述：商品的详细描述信息，通常包含HTML格式的文本，用于在商品详情页展示。
• 商品规格参数：商品的详细规格参数，如尺寸、重量、材质等。

3. 销售与促销信息

• 销售量：商品的销售数量，可能以件、笔或箱等单位表示。
• 好评率：商品的好评比例。
• 促销活动：当前商品的促销活动信息，如满减、打折、优惠券等。
• 促销价格区间：如果有多个促销活动，可能返回促销价格区间。

4. 物流信息

• 发货地：商品的发货地点。
• 运费模板：商品的运费模板信息，包括包邮条件、运费计算规则等。

5. 售后服务

• 退换货政策：商品的退换货政策描述。
• 保修期限：商品的保修期限信息。

6. 关联推荐

• 关联商品：与当前商品相关的其他商品推荐，可能包括相似商品、搭配商品等。
• 店铺推荐：包含该商品的店铺内其他热门商品或新品推荐。

7. 商家信息

• 店铺ID：销售该商品的店铺ID。
• 店铺名称：销售该商品的店铺名称。
• 店铺评分：店铺的整体评分，可能包括描述相符、服务态度、物流速度等方面的评分。

8. 其他信息

• 上架时间：商品的上架时间。
• 更新时间：商品信息的最后更新时间。
• 商品类型：商品的分类信息，可能包括多级分类。