API文档中心

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

唯品会联盟相似商品推荐列表接口

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

此API用于唯品会联盟相似商品推荐。接口最多返回40个商品,也有可能返回极少或无相似商品推荐,需做好判断。

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
goodsId String   商品id
page Integer 1 分页页码:从1开始
pageSize Integer 20 分页大小:默认20
plat Integer   用户平台:1-PC,2-APP,3-小程序,不传默认为APP
deviceType String   设备号类型:IMEI,IDFA,OAID,有则传入
deviceValue String   设备号MD5加密后的值,有则传入,IDFA大写后md5,IMER小写后md5,OAID原文md5
ip String   用户ip地址
longitude String 29.590961456298828 经度
latitude String 106.51573181152344 纬度
warehouse String   分仓 :VIP_NH:广州仓,VIP_SH:上海仓, VIP_BJ:北京仓,VIP_CD:成都仓, VIP_HZ:华中仓, ALL:全国仓
queryReputation Boolean   是否查询商品评价信息:默认不查询,该数据在详情页有返回,没有特殊需求,建议不查询,影响接口性能
queryStoreServiceCapability Boolean   是否查询店铺服务能力信息:默认不查询,该数据在详情页有返回,没有特殊需求,建议不查询,影响接口性能
queryStock Boolean   是否查询库存:默认不查询
queryActivity Boolean   是否查询商品活动信息:默认不查询
queryPrepay Boolean   是否查询商品预付信息:默认不查询
chanTag String   自定义渠道标识
queryCpsInfo Integer   是否返回cps链接:0-不查询,1-tra_from参数,2-小程序链接,默认为0,查询多个时按照位运算处理,例如:3表示查询tra_from参数+小程序链接
queryFuturePrice Boolean   是否查询未来价信息:默认不查询
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_similaritems?vekey=xxx&goodsId=6918063477819748893 

使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/vip/vip_similaritems?vekey=xxx&goodsId=6918063477819748893";

$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_similaritems?vekey=xxx&goodsId=6918063477819748893";
        // 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_similaritems?vekey=xxx&goodsId=6918063477819748893"

# 发送请求
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   店铺名称
commentsInfo Goodscommentsinfo   商品评价信息
storeServiceCapability Storeservicecapability   商品所属店铺服务能力评价
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 List   商品参与活动信息:未参与活动集合为空
 └─ actType Integer   活动类型:18-唯品快抢
 └─ actName String   活动名称
 └─ beginTime Long   开始时间:时间戳,单位毫秒
 └─ endTime Long   结束时间:时间戳,单位毫秒
couponInfo Pmscouponinfo   红包信息
 └─ 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
goodsIdsWithSameSpu List   同spuId扩展商品id: 新版详情接口返回,其余接口不返回该字段
skuInfos List   对应sku信息
 └─ sizeId String   商品尺码id(唯品会体系下和skuId等同)
 └─ saleProps Map   售卖属性信息(134 - 颜色,453 - 尺码)
 └─ leavingStock Integer   剩余库存:查询库存时返回
 └─ saleStockStatus Integer   商品库存状态:1-已抢光,2-有库存,3-有机会
 └─ vipPrice String   唯品价:单位元
 └─ marketPrice String   市场价:单位元
exclusiveCoupon Map   渠道专属红包:目前仅开放单品券,没有则返回空
 └─ couponNo String   优惠券批次号
 └─ couponName String   优惠劵名称
 └─ fav String   优惠金额:单位-元,查询详情时返回
 └─ buy String   使用门槛:单位-元,查询详情时返回
 └─ activateBeginTime Long   券激活开始时间,毫秒级时间戳
 └─ activateEndTime Long   券激活结束时间,毫秒级时间戳
 └─ useBeginTime Long   使用开始时间,毫秒级时间戳
 └─ useEndTime Long   使用结束时间,毫秒级时间戳
 └─ totalAmount Long   生成劵的总量:查询详情时返回
 └─ activedAmount Long   劵已激活的数量:查询详情时返回
 └─ receiveUrl String   专属领券页地址
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   商品销量

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
[ { "marketPrice": "355.00", "commissionRate": "1", "goodsId": "6920097275609016989", "discount": "0.50", "couponPriceType": 0, "categoryName": "洁面", "haiTao": 1, "cat2ndName": "面部护理", "isSubsidyActivityGoods": false, "cat1stName": "美容护肤", "vipPrice": "145.00", "commission": "1.45", "productSales": "1万+", "sn": "027131988083", "cat1stId": 1012, "goodsName": "雅诗兰黛 净莹多效洁面啫喱150ml", "brandName": "EsteeLauder", "brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/9bbd1f8bffe542b495f51199462ee8b3/10000794/primary.png", "brandStoreSn": "10000794", "sellTimeFrom": 1538940223000, "schemeStartTime": 1635510695000, "schemeEndTime": 2517544800000, "goodsSoldNumDesc": "", "sourceType": 0, "sellTimeTo": 1735660800000, "brandId": 1710620765, "goodsThumbUrl": "https://a.vpimg4.com/upload/merchandise/pdcvis/2022/11/09/123/462d2fc7-e204-4ac1-afff-c4a44646bfe1_750x750_50.jpg", "cat2ndId": 1014, "spuId": "SPU-123F7C308000030F", "storeInfo": { "storeName": "唯品自营", "storeId": "ST00000" }, "estimatePrice": "", "goodsMainPicture": "https://a.vpimg2.com/upload/merchandise/pdcvis/2022/11/09/123/462d2fc7-e204-4ac1-afff-c4a44646bfe1.jpg", "destUrl": "https://m.vip.com/product-1710620765-6920097275609016989.html", "categoryId": 390656, "status": 1 } ]

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部