API文档中心

热门接口：产品ID找同款全量维权查询万能转链字符串ID转换 （有API需求可联系本站）

获取唯品会指定id的商品SKU等信息接口

调用权限：核心接口会员卡调用
 接口测试 
接口使用场景等说明：

此API可获取唯品会联盟的指定商品信息，包括标题，商品图文介绍，以及SKU（和vip_goodsinfo接口主要区别）等信息。

如果你需要查询商品SKU信息，请添加extendSku=true参数。


支持批量查询唯品会（vip）商品信息，商品id列表限制最大10条。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/vip/vip_goodsinfov2 暂无

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
goodsIds String 否 11111,2222 商品id列表，最多不超过10个
extendSku Boolean 否 true 是否扩展查询商品sku信息:此参数为true时，将根据传入的商品id扩展查询出对应的sku信息，默认为false。指定此参数查询较耗时，建议单个查询，并且业务上避免重复查询场景
queryDetail Boolean 否 true 是否查询详情信息：此参数设为true，将查询出商品轮播图和详情图，默认为false
queryStock Boolean 否 true 是否查询商品库存状态：默认为false
queryReputation Boolean 否 true 是否查询商品评价信息：默认为false
queryStoreServiceCapability Boolean 否   是否查询商品所属店铺服务能力信息：默认为false
queryPMSAct Boolean 否   是否查询商品活动信息:默认为false
queryPrepay Boolean 否   是否查询商品预付信息:默认为false
chanTag String 否   用户pid，自定义参数
extendBySpu Boolean 否   是否按照同spu扩展:此参数为true时，将根据传入的商品id扩展查询出同spu下的所有商品id，默认为false
sizeIdMap Map 否   商品id对应sizeId集合:指定查询商品id下sizeId对应信息,key为goodsId，value为sizeId(等同于skuId)
queryExclusiveCoupon Boolean 否   是否查询渠道专属红包信息：默认不查询
commonParams Commonparams 否   通用参数
 └─ common_plat Integer 否 1 用户平台：1-PC,2-APP,3-小程序,不传默认为APP
 └─ common_deviceType String 否   设备号类型：IMEI，IDFA，OAID，有则传入
 └─ common_deviceValue String 否   设备号MD5加密后的值，有则传入,IDFA大写后md5，IMER小写后md5，OAID原文md5
 └─ common_ip String 否   用户ip地址
 └─ common_longitude String 否   经度 如:29.590961456298828
 └─ common_latitude String 否   纬度 如:106.51573181152344
 └─ common_warehouse String 否   分仓 VIP_NH：广州仓， VIP_SH：上海仓， VIP_BJ：北京仓，VIP_CD：成都仓， VIP_HZ：华中仓， ALL：全国仓
queryCpsInfo Integer 否   是否返回cps链接：0-不查询，1-tra_from参数,2-小程序链接，默认为0，查询多个时按照位运算处理，例如：3表示查询tra_from参数+小程序链接
queryFuturePrice Boolean 否   是否查询未来价信息：默认不查询
querySubsidyActFlag Boolean 否 false 是否查询补贴活动商品信息
openId String 否 556599542235 自定义的标记渠道用户在渠道侧的用户唯一标识（必传）（如已接入sdk，该值为渠道用户授权绑定唯品会账号的标识，如没接入sdk，该值为渠道用户在渠道侧的用户唯一标识）不能含有特殊字符，仅限字母、数字、下划线，长度最大32，用于识别用户并给用户返利分佣（非常重要！传错影响给用户返利分佣）如果当前调用与用户无关，比如后台job触发拉取商品，则传默认标识：default_open_id (转链接口不论是否实时调用都必须传实际的 open_id)。调转链接口与商品接口时，同一用户openId传参需要一致订单里面会带上转链时所传的openId信息。
realCall Boolean 否 false 2023.7.1后新增的参数：是否实时调用，true：由用户实时触发的请求，实时给用户展示联盟返回的商品信息或者实时给用户转链生成推广链接。 false：不是由用户实时触发，由渠道后台job触发的请求，比如渠道后台job定期调联盟接口拉取商品到渠道自己的库，请按实际情况传该参数。

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/vip/vip_goodsinfov2?vekey=xxx&goodsIds=6919944819398719702&queryDetail=true 

【例子】增加commonParams参数
http://api.veapi.cn/vip/vip_goodsinfov2?vekey=xxx&goodsIds=6919944819398719702&common_plat=1
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/vip/vip_goodsinfov2?vekey=xxx&goodsIds=6919944819398719702&queryDetail=true";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流，不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool，以hutool为例：

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/vip/vip_goodsinfov2?vekey=xxx&goodsIds=6919944819398719702&queryDetail=true";
        // JDK 8u111版本后，若目标页面为HTTPS协议，请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时，毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests，支持访问http,https网页：

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/vip/vip_goodsinfov2?vekey=xxx&goodsIds=6919944819398719702&queryDetail=true"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值（JSON）

参数名称 参数类型 是否必选 示例值 描述
goodsId String 否   商品id
goodsName String 否   商品名称
goodsDesc String 否   商品描述,字段暂不输出
destUrl String 否   商品落地页
goodsThumbUrl String 否   商品缩略图
goodsCarouselPictures List 否   商品轮播图：根据商品id查询时返回，商品列表不返回
goodsMainPicture String 否   商品主图
categoryId Long 否   商品三级分类id
categoryName String 否   商品三级分类
sourceType Integer 否   商品类型：0-自营，1-MP
marketPrice String 否   市场价（元）
vipPrice String 否   唯品价（元）
commissionRate String 否   佣金比例（%）
commission String 否   佣金金额（元）
discount String 否   折扣:唯品价/市场价,保留两位小数字符串
goodsDetailPictures List 否   商品详情图片：根据商品id查询商品信息时返回，商品列表不返回
cat1stId Long 否   商品一级分类id
cat1stName String 否   商品一级分类名称
cat2ndId Long 否   商品二级分类id
cat2ndName String 否   商品二级分类名称
brandStoreSn String 否   商品品牌sn
brandName String 否   商品品牌名称
brandLogoFull String 否   商品品牌logo全路径地址
schemeEndTime Long 否   商品推广计划有效期预估截止时间：仅为预估时间，仅做参考；时间戳，单位：毫秒
sellTimeFrom Long 否   商品售卖开始时间,时间戳，单位毫秒
sellTimeTo Long 否   商品售卖结束时间,时间戳,单位毫秒
weight Integer 否   推广权重，用于确定推广该商品的优先级，权重值越大，优先级越高
storeInfo Storeinfo 否   店铺信息
 └─ storeId String 否 唯品自营 店铺id
 └─ storeName String 否 ST00000 店铺名称
commentsInfo Map 否   商品评价信息
 └─ comments Integer 否 11496 商品评论数
 └─ goodCommentsShare String 否 99.00 商品好评率:百分比，不带百分号
storeServiceCapability Map 否   商品所属店铺服务能力评价
 └─ storeScore String 否 98 店铺评分：保留两位小数
 └─ storeRankRate String 否 1.00 店铺同品类排名比例：例如10表示前10%
brandId Long 否   商品所属档期（专场）id
schemeStartTime Long 否   商品所属推广方案开始时间：时间戳，单位：毫秒
saleStockStatus Integer 否   商品库存状态：1-已抢光，2-有库存，3-有机会,当列表查询库存或者查询商品详情时返回
status Integer 否   商品状态：0-下架，1-上架
prepayInfo Prepayinfo 否   商品预付信息
 └─ isPrepay Integer 否 0 是否预付商品:0-否，1-是
 └─ prepayPrice String 否 56.00 预付到手价：元
 └─ firstAmount String 否   预付首款金额：元
 └─ lastAmount String 否   预付尾款金额：元
 └─ prepayFavAmount String 否   预付优惠金额:元
 └─ deductionPrice String 否   抵扣价格(首款+优惠金额)：元
 └─ prepayDiscount String 否   预付折扣：(唯品价-优惠金额)/唯品价,保留两位小数的数字字符串
 └─ prepayFirstStartTime Long 否   首款支付开始时间:时间戳,单位毫秒
 └─ prepayFirstEndTime Long 否   首款支付结束时间:时间戳,单位毫秒
 └─ prepayLastStartTime Long 否   尾款支付开始时间:时间戳,单位毫秒
 └─ prepayLastEndTime Long 否   尾款支付结束时间:时间戳,单位毫秒
joinedActivities Map 否   商品参与活动信息:未参与活动集合为空
 └─ actType Integer 否   活动类型:18-唯品快抢
 └─ actName String 否   活动名称
 └─ beginTime Long 否   开始时间：时间戳，单位毫秒
 └─ endTime Long 否   结束时间：时间戳，单位毫秒
 └─ foreShowBeginTime Long 否   预热开始时间：时间戳，单位毫秒
couponInfo Map 否   红包信息
 └─ useBeginTime Long 否 1673280000000 使用开始时间，毫秒级时间戳
 └─ useEndTime Long 否 1673280000000 使用结束时间，毫秒级时间戳
 └─ couponNo String 否   优惠券批次号
 └─ couponName String 否 红包5元 优惠劵名称
 └─ couponType Byte 否 5 券类型,(1:买赠 2:满减 3:折扣 4:免邮 5:多减多减)
 └─ buy String 否 5.00 使用门槛
 └─ fav String 否 5.00 优惠金额
 └─ activateBeginTime Long 否 1673316000000 券激活开始时间,毫秒级时间戳
 └─ activateEndTime Long 否 1673316000000 券激活结束时间,毫秒级时间戳
 └─ totalAmount Long 否 10000 生成劵的总量
 └─ activedAmount Long 否 -1 劵已激活的数量
 └─ vipPrice Double 否   唯品价(用于券的展示逻辑)
 └─ hiddenCouponReceiveUrl String 否   隐藏红包领券页链接
haiTao Integer 否   是否海淘商品标识：1是 0不是
spuId String 否   商品spuId
skuInfos Map 否   对应sku信息
 └─ sizeId String 否   商品尺码id(唯品会体系下和skuId等同)
 └─ saleProps Map 否   售卖属性信息（134 - 颜色,453 - 尺码）
 └─ leavingStock Integer 否   剩余库存:查询库存时返回
 └─ saleStockStatus Integer 否   商品库存状态：1-已抢光，2-有库存，3-有机会
 └─ vipPrice String 否   唯品价:单位元
 └─ marketPrice String 否   市场价:单位元
goodsIdsWithSameSpu List 否   同spuId扩展商品id:新版详情接口返回，其余接口不返回该字段
exclusiveCoupon Map 否   渠道专属红包：目前仅开放单品券，没有则返回空.下级字段参考couponInfo信息。
cpsInfo Map 否   cps推广信息：目前只返回小程序链接和通用追踪参数，其他链接请移步转链接口,1-通用推广参数(tra_from)，2-唯品会微信小程序链接
sn String 否   商品货号/商品原编号
tagNames List 否   商品标签
whiteImage String 否   商品透明底图
futurePriceMsg String 否   商品未来价信息
isSubsidyActivityGoods Boolean 是   是否为补贴活动商品标识，默认为false
subsidyActivityAmount String 否   补贴活动奖励金额（单位：元）
subsidyTaskNo String 否   补贴活动任务编码
couponPriceType Integer 否   券后价类型：0-否，1-公开券后价，2-隐藏券后价
estimatePrice String 否   商品预估价格
goodsSoldNumDesc String 否   商品销量文案(仅2小时榜单和今日榜单会返回)，例如：1万+
productSales String 否   商品销量

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "接口调用成功！", "data": [ { "marketPrice": "999.00", "commissionRate": "11", "goodsId": "6919944819398719702", "discount": "0.20", "couponPriceType": 0, "categoryName": "女式羽绒服", "haiTao": 0, "cat2ndName": "女上装", "isSubsidyActivityGoods": false, "cat1stName": "女装", "vipPrice": "121.00", "commission": "13.31", "productSales": "9万+", "sn": "J10141478WD-6001", "cat1stId": 311, "goodsName": "【HOT热销】羽绒服女冬时尚休闲短款小个子面包服保暖羽绒外套", "brandName": "BENGEN", "brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/LOGO/166599628431903f5f/primary.png", "brandStoreSn": "10025705", "sellTimeFrom": 1658487063000, "schemeStartTime": 1673193600000, "schemeEndTime": 1673366399000, "sourceType": 0, "sellTimeTo": 1735660800000, "brandId": 1712149750, "goodsThumbUrl": "https://a.vpimg3.com/upload/merchandise/pdcvis/2022/07/21/66/9e5be95f-0a43-418d-ab78-d01d46896a84_750x750_50.jpg", "cat2ndId": 312, "spuId": "SPU-1129DE7680380107", "storeInfo": { "storeName": "唯品自营", "storeId": "ST00000" }, "estimatePrice": "", "goodsMainPicture": "https://a.vpimg4.com/upload/merchandise/pdcvis/2022/07/21/66/9e5be95f-0a43-418d-ab78-d01d46896a84.jpg", "destUrl": "https://m.vip.com/product-1712149750-6919944819398719702.html", "categoryId": 390562, "status": 1 } ], "request_id": "KxiYE3c" }

错误码

如果error不为0时，请点此查看错误码表格

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部