技术实战：唯品会商品详情API接入指南与JSON返回参考
前言
在品牌折扣选品、正品货源监控、多平台价格比价的业务场景中，唯品会商品详情API是电商从业者最核心的结构化数据入口。它无需搭建复杂的反爬体系，就能稳定获取全维度的唯品会品牌商品信息，大幅降低品牌折扣选品、库存监控类业务的开发门槛，是打通唯品会品牌货源数据与自有电商系统的必备工具。
一、接口核心覆盖的数据范围
这套接口可以返回品牌折扣电商业务开发中几乎所有需要的唯品会商品核心字段，完全适配品牌选品、价格监控、正品溯源等多种场景：
基础标识：商品唯一ID、商品标题、所属品牌ID、品牌名称、所属特卖会ID、特卖会开始/结束时间、商品上架时间
价格体系：专柜原价、当前特卖价、VIP会员专享价、满减抵扣金额、限时闪购价，所有价格数据支持分钟级更新
交易属性：特卖期累计销量、商品好评率、总评价数、品牌授权标识、发货地、唯品会自营标识
规格库存：全SKU列表、每个子规格的对应特卖价、实时可售库存、颜色/尺码/款号等属性明细
素材资源：多尺寸主图数组、详情图列表、品牌授权素材链接、商品短视频地址、品牌溯源信息图
附加信息：商品参数详情、正品保障政策、物流配送时效、7天无理由退换规则、关联推荐同品牌商品列表
二、最简接入操作步骤
结合之前1688、速卖通等电商接口的开发经验，新手跟着3步就能快速完成适配调用：
登录唯品会开放平台，注册开发者账号，创建应用并申请商品详情查询接口权限，获取专属的App Key和App Secret（o0b.cn/anzexi）
按照官方规范生成合法签名，将所有非空请求参数按字典序排序后拼接密钥，通过MD5加密生成验签值
用HTTPS POST方式将请求提交到唯品会API网关，传入目标商品ID，即可直接返回标准JSON格式的结构化商品数据
三、可直接参考的成功返回JSON示例
这是脱敏后的标准返回结构，完全匹配唯品会开放平台官方商品详情接口的原生返回格式，核心字段都标注了业务含义，可直接用于开发调试参考：
{
"code": 0,
"msg": "success",
"request_id": "req_2026081715332867",
"data": {
"product_id": 12345678901,
"title": "Nike 2026新款男子透气运动跑步鞋 品牌特卖 正品保障",
"brand_info": {
"brand_id": 98765,
"brand_name": "耐克Nike",
"is_authorized": true,
"brand_logo": "https://img.vip.com/brand/nike_logo.png"
},
"sale_activity": {
"activity_id": 456789,
"activity_name": "Nike运动品牌日特卖会",
"start_time": "2026-08-15T00:00:00",
"end_time": "2026-08-22T23:59:59"
},
"price_info": {
"market_price": "899.00",
"current_sale_price": "399.00",
"vip_price": "369.00",
"coupon_price": "349.00",
"coupon_desc": "满399减50品牌专属券"
},
"sales_info": {
"activity_sales": 12680,
"good_rate": "98.6%",
"total_reviews": 5689,
"is_vipself": true
},
"stock_info": {
"total_stock": 3260,
"is_on_sale": true,
"delivery_place": "广东佛山唯品会自营仓",
"delivery_time": "48小时内发货"
},
"image_info": {
"main_images": [
"https://img.vip.com/123/456/abc123_1.jpg",
"https://img.vip.com/123/456/abc123_2.jpg",
"https://img.vip.com/123/456/abc123_3.jpg"
],
"detail_images": [
"https://img.vip.com/123/456/def456_1.jpg",
"https://img.vip.com/123/456/def456_2.jpg"
],
"video_url": "https://v.vip.com/123/ghi789.mp4"
},
"sku_list": [
{
"sku_id": 1234567890101,
"spec_text": "黑白配色 42码",
"sku_price": "399.00",
"sku_stock": 860
},
{
"sku_id": 1234567890102,
"spec_text": "灰蓝配色 43码",
"sku_price": "399.00",
"sku_stock": 920
},
{
"sku_id": 1234567890103,
"spec_text": "全黑配色 41码",
"sku_price": "399.00",
"sku_stock": 1480
}
],
"product_params": [
{"name": "鞋面材质", "value": "飞织透气网面"},
{"name": "鞋底材质", "value": "耐磨橡胶气垫底"},
{"name": "适用场景", "value": "跑步/日常休闲"}
],
"after_sale": {
"support_return": true,
"return_days": 7,
"authentic_guarantee": true,
"support_insurance": true
}
}
}