淘宝/天猫的开放平台提供了一系列的API供开发者调用,其中获取商品详情是常见的功能之一。高级版的商品详情API通常提供更多的字段和信息,相对于基础版更加详细。以下是一个大致的淘宝/天猫商品详情高级版API返回值的说明,请注意这只是一个参考模板,具体的返回值可能会因API版本、调用方式或商品类型的不同而有所差异。
{
"taobao_response": {
"num_iid": "商品数字ID",
"title": "商品标题",
"nick": "卖家昵称",
"pict_url": "商品主图URL",
"price": "商品销售价",
"market_price": "商品市场价",
"num": "商品库存数量",
"barcode": "商品条形码",
"sell_point": "商品卖点",
"category": "商品类目",
"provcity": "商家所在地",
"item_location": "商品发货地",
"valid_thru": "商品有效期",
"postage_id": "邮费模板ID",
"is_3d": "是否为3D商品",
"is_ex": "是否是天猫国际商品",
"is_taobao": "是否为淘宝商品(与is_tmall互斥)",
"is_tmall": "是否为天猫商品(与is_taobao互斥)",
"is_promotion": "商品是否在促销",
"promotion_type": "促销类型",
"promotion_price": "促销价格",
"outer_id": "外部商品ID",
"payment_way": "支持的支付方式",
"store_category": "店铺类目",
"has_discount": "是否有折扣",
"discount_rate": "折扣率",
"has_invoice": "是否有发票",
"invoice_type": "发票类型",
"sku_properties_name": "SKU属性名称列表",
"sku_quantity": "SKU库存数量列表",
"sku_price": "SKU价格列表",
"sku_id": "SKU ID列表",
"service_list": {
"退换货承诺": "退换货承诺天数",
"基础服务": "是否支持7天无理由退换货等",
"...": "..."
},
"tags": ["标签1", "标签2", "..."],
"attributes": {
"颜色": "红色",
"尺寸": "L",
"...": "..."
},
"related_products": [
{
"num_iid": "相关商品数字ID",
"title": "相关商品标题",
"pict_url": "相关商品主图URL",
"...": "..."
},
"..."
],
"create_time": "商品创建时间",
"update_time": "商品更新时间",
"type": "商品类型",
"state": "商品状态",
"property_alias": "属性别名",
"coupon_count": "优惠券数量",
"has_coupon": "是否有优惠券",
"volume": "商品体积",
"weight": "商品重量",
"package_list": [
{
"id": "包装ID",
"name": "包装名称",
"price": "包装价格",
"quantity": "包装数量",
"material": "包装材料"
},
"..."
],
"after_sale_service": {
"type": "售后服务类型",
"detail": "售后服务详情"
},
"logistics_company": "物流公司",
"logistics_fee": "物流费用",
"delivery_time": "发货时间",
"has_extended_warranty": "是否有延保服务",
"extended_warranty_period": "延保服务期限",
"extended_warranty_fee": "延保服务费用",
"brand_id": "品牌ID",
"brand_name": "品牌名称",
"product_type": "商品类型",
"model_id": "型号ID",
"model_name": "型号名称",
"origin": "产地",
"warranty_period": "质保期",
"warranty_type": "质保类型",
"is_personal_custom": "是否个人定制是的,淘宝/天猫的商品详情高级版API通常会返回更多关于商品的详细信息。以下是一些可能包含在返回值中的额外字段和它们的说明:
```json
{
"is_3d": "是否为3D商品",
"is_virtual": "是否为虚拟商品",
"virtual_expire_days": "虚拟商品过期天数",
"outer_id": "商家自定义编号",
"is_preorder": "是否为预售商品",
"preorder_end_time": "预售结束时间",
"has_seckill": "是否为秒杀商品",
"seckill_start_time": "秒杀开始时间",
"seckill_end_time": "秒杀结束时间",
"group_buy_count": "团购人数",
"group_buy_price": "团购价格",
"is_on_sale": "商品是否上架",
"is_exclusive": "是否为专享商品",
"exclusive_start_time": "专享开始时间",
"exclusive_end_time": "专享结束时间",
"member_price": "会员价",
"vip_discount": "会员折扣",
"store_vip_price": "店铺会员价",
"flash_sale_price": "闪购价",
"flash_sale_start_time": "闪购开始时间",
"flash_sale_end_time": "闪购结束时间",
"is_new": "是否为新品",
"new_start_time": "新品上架开始时间",
"new_end_time": "新品上架结束时间",
"hot_score": "热度评分",
"sale_count": "销量",
"comment_count": "评论数",
"good_comment_rate": "好评率",
"is_favorite": "是否为推荐商品",
"favorite_count": "推荐数",
"favorite_start_time": "推荐开始时间",
"favorite_end_time": "推荐结束时间",
"is_promotion": "是否为促销商品",
"promotion_type": "促销类型",
"promotion_desc": "促销描述",
"promotion_price": "促销价",
"original_price": "原价",
"market_price": "市场价",
"min_price": "最低价",
"max_price": "最高价",
"price_unit": "价格单位",
"barcode": "条形码",
"ean_code": "EAN码",
"isbn": "ISBN号",
"upc_code": "UPC码",
"mpn": "MPN码",
"sku_weight": "SKU重量",
"sku_volume": "SKU体积",
"inventory_warning_number": "库存预警数量",
"out_of_stock_handling_time": "缺货处理时间",
"category_path": "商品分类路径",
"primary_category_id": "主分类ID",
"primary_category_name": "主分类名称",
"secondary_category_id": "子分类ID",
"secondary_category_name": "子分类名称",
"brand_logo": "品牌Logo图片URL",
"product_brief": "商品简介",
"product_detail": "商品详情",
"main_image_url": "主图URL",
"gallery_images": ["轮播图URL1", "轮播图URL2", "..."],
"detail_images": ["详情图URL1", "详情图URL2", "..."],
"other_images": ["其他图片URL1", "其他图片URL2", "..."],
"video_url": "商品视频URL",
"pc_detail_url": "PC端商品详情页URL",
"mobile_detail_url": "移动端商品详情页URL",
"video_detail_url": "视频详情页URL",
"original_image_url": "原图URL",
"watermark_image_url": "水印图URL",
"product_weight": "商品重量",
"product_length": "商品长度",
"product_width": "商品宽度",
"product_height": "商品高度",
"package_weight": "包装重量",
"package_length": "包装长度",
"package_width": "包装宽度