淘宝商品详情API接口(如taobao.item.get
)可以获取以下关键信息:
- 商品基础信息
- 商品ID(
num_iid
):唯一标识商品的编号。 - 商品标题(
title
):商品的名称或描述。 - 商品价格(
price
):当前销售价格。 - 商品原价(
original_price
):商品的原价或划线价。 - 库存数量(
stock
):商品的剩余库存。 - 销量数据(
volume
或sold_quantity
):月销量或总销量(需通过fields
参数指定)。
- 商品ID(
- 商品图片信息
- 主图URL(
pic_url
):商品主图的图片地址。 - 商品图片列表(
item_imgs
):商品的多张图片,包括详情图、SKU属性图片等。
- 主图URL(
- 商品描述信息
- 商品详情HTML(
desc
):商品的详细描述内容,通常为HTML格式。
- 商品详情HTML(
- SKU信息
- SKU列表(
sku
):商品的各个SKU信息,包括:- SKU ID(
sku_id
):唯一标识SKU的编号。 - 属性组合(
properties
):如颜色、尺码等属性的组合。 - SKU价格(
price
):该SKU的价格。 - SKU库存(
quantity
):该SKU的库存数量。
- SKU ID(
- SKU列表(
- 商品属性信息
- 属性名称(
props_name
):商品的属性名称,如“颜色分类:黑色;尺码:42”。
- 属性名称(
- 物流信息
- 发货地(
location
):商品的发货地点。 - 运费信息(
post_fee
、express_fee
、ems_fee
):包邮或不同快递方式的运费。
- 发货地(
- 商品链接信息
- 商品详情页URL(
detail_url
):商品的淘宝详情页链接。
- 商品详情页URL(
- 其他信息
- 卖家信息(如
seller_id
、shop_title
):卖家的ID和店铺名称。 - 信用评分(
credit_score
):卖家的信用评分。
- 卖家信息(如
注意事项
- 字段指定:通过
fields
参数明确指定需要返回的字段,例如:python
params['fields'] = 'num_iid,title,price,volume,pic_url,sku,item_imgs,props_name'
- 接口限制:部分字段(如
sold_quantity
)可能需特殊权限或接口版本支持,需测试验证。 - 数据更新:商品信息可能实时变化,建议缓存数据并定期更新。
示例返回数据结构
json
{ | |
"item_get_response": { | |
"item": { | |
"num_iid": "1234567890", | |
"title": "2024新款男士运动鞋", | |
"price": "199.00", | |
"volume": 1500, | |
"pic_url": "https://img.alicdn.com/xxx.jpg", | |
"sku": [ | |
{ | |
"sku_id": "4567890123", | |
"properties": "1627207:28326;1627208:28328", | |
"quantity": "100", | |
"price": "199.00" | |
} | |
], | |
"item_imgs": [ | |
{"url": "https://img.alicdn.com/xxx_1.jpg"}, | |
{"url": "https://img.alicdn.com/xxx_2.jpg"} | |
], | |
"props_name": "颜色分类:黑色;尺码:42", | |
"location": "浙江杭州", | |
"post_fee": "0.00", | |
"detail_url": "https://item.taobao.com/item.htm?id=1234567890" | |
} | |
} | |
} |
通过合理使用淘宝商品详情API接口,开发者可以获取丰富的商品数据,支持电商分析、竞品监控、价格比较等场景。