淘宝商品详情 API 接口(如 taobao.item.get
)的 JSON 数据返回示例如下:
json { "request_id": "your_unique_request_id", "code": 0, "msg": "success", "item": { "id": "123456789", "title": "商品标题示例", "price": "199.00", "nick": "卖家昵称", "shop_id": "987654321", "shop_name": "店铺名称", "desc": "这里是商品的详细描述...", "detail_url": "https://item.taobao.com/item.htm?id=123456789", "skus": [ { "id": "sku_id_1", "price": "199.00", "stock": "100", "properties": "颜色:红色;尺码:L" } ], "images": [ "http://img.example.com/product1.jpg", "http://img.example.com/product2.jpg" ], "properties": [ { "name": "品牌", "value": "XX品牌" }, { "name": "材质", "value": "棉" } ], "coupon_info": { "amount": "10.00" }, "promotions": [ { "type": "满减", "desc": "满200减20" } ] } }
字段说明:
- 基础信息:
id
:商品ID,唯一标识商品。title
:商品标题,展示商品的名称或描述。nick
:卖家昵称,表示销售该商品的卖家名称。shop_id
:店铺ID,用于唯一标识销售该商品的店铺。shop_name
:店铺名称,展示销售该商品的店铺名称。desc
:商品描述,包含商品的详细介绍、使用说明等。detail_url
:商品详情页URL,用于访问商品的详细页面。
- 价格与库存:
price
:商品价格,单位通常为元,表示商品的售价。skus
:SKU列表,如果商品有多个SKU(如不同颜色、尺码等),则包含多个SKU对象。每个SKU对象包含SKU的ID、价格、库存量、属性等信息。
- 图片与属性:
images
:商品图片列表,包含商品的多张图片URL,如主图、详情图等。properties
:商品属性列表,包含商品的多个属性及其值,如品牌、材质等。
- 促销与优惠券:
coupon_info
:优惠券信息(如果有),包含优惠券的金额等相关信息。promotions
:促销活动列表(如果有),包含促销活动的类型、描述等信息。
调用注意事项:
- API权限:使用淘宝商品详情数据API接口需要注册并获取相应的API权限,包括API密钥(AppKey和AppSecret)等必要的认证信息。
- 调用频率限制:淘宝API对接口的调用频率有严格的限制,超过限制会导致接口被封禁。开发者需要根据自身业务需求合理规划调用频率。