唯品会猜你喜欢商品列表|唯品会猜你喜欢|唯品会返佣|唯品会返利|唯品会接口|订单侠开放平台

接口支持https，非大陆服务器（含港澳台）调用接口会出现网络缓慢现象，请联系客服获取国外专线接口

参数接口

参数类型

必填

示例

说明

apikey

string

是

接口秘钥，请登录后台获取

page

Integer

是

1

分页页码：从1开始

pageSize

Integer

否

20

分页大小：默认20

inStock

Integer

否

是否有货 1:有货 0:无货默认1

goodsSaleStats

Integer

否

商品售卖状态 1（在售）， 2（预热）， 3（在售+预热）默认1

offlineStore

Integer

否

筛选线下店商品：1只返线下店，0或者不传只返回特卖会

plat

Integer

否

用户平台：1-PC,2-APP,3-小程序,不传默认为APP

deviceType

String

否

设备号类型：IMEI，IDFA，OAID，有则传入

deviceValue

String

否

设备号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：全国仓

chanTag

String

否

自定义渠道标识

queryCpsInfo

Integer

否

是否返回cps链接：0-不查询，1-tra_from参数,2-小程序链接，默认为0，查询多个时按照位运算处理，例如：3表示查询tra_from参数+小程序链接

标记

类型

例子

说明

goodsId

String

商品id

goodsName

String

商品名称

destUrl

String

商品落地页

goodsThumbUrl

String

商品缩略图

goodsCarouselPictures

String

商品主图

categoryId

LONG

商品三级分类id

categoryName

String

商品三级分类

sourceType

Integer

商品类型：0-自营，1-MP

marketPrice

String

市场价（元）

vipPrice

String

唯品价（元）

commissionRate

String

佣金比例（%）

commission

String

佣金金额（元）

discount

String

折扣:唯品价/市场价保留两位小数字符串

cat1stId

LONG

商品一级分类id

cat1stName

String

商品一级分类名称

cat2ndId

LONG

商品二级分类id

cat2ndName

String

商品二级分类名称

brandStoreSn

String

商品品牌sn

brandName

String

商品品牌名称

storeInfo

StoreInfo

店铺信息

L storeId

String

店铺id

L storeName

String

店铺名称

cpsInfo

Map<Integer, String>

cps推广信息：目前只返回小程序链接和通用追踪参数，其他链接请移步转链接口,1-通用推广参数(tra_from)，2-唯品会微信小程序链接

skuInfos

List<GoodsSkuInfo>

对应sku信息

L sizeId

String

商品尺码id(唯品会体系下和skuId等同)

L saleProps

Map<Integer, String>

售卖属性信息（134 - 颜色,453 - 尺码）

L leavingStock

Integer

剩余库存:查询库存时返回

L saleStockStatus

Integer

商品库存状态：1-已抢光，2-有库存，3-有机会

L vipPrice

String

唯品价:单位元

L marketPrice

String

市场价:单位元

couponInfo

PMSCouponInfo

红包信息

L couponNo

String

优惠券批次号

L couponName

String

优惠劵名称

L buy

String

使用门槛

L fav

String

优惠金额

L activateBeginTime

LONG

券激活开始时间,毫秒级时间戳

L activateEndTime

LONG

券激活结束时间,毫秒级时间戳

L useBeginTime

LONG

使用开始时间，毫秒级时间戳

L useEndTime

LONG

使用结束时间，毫秒级时间戳

L totalAmount

LONG

生成劵的总量

L activedAmount

LONG

劵已激活的数量

haiTao

Integer

是否海淘商品标识：1是 0不是

spuId

String

商品spuId

status

Integer

商品状态：0-下架，1-上架

{code: 200,
msg: "请求成功【success】",
total_results: 2,
data: [{marketPrice: "1489.00",
commissionRate: "3",
goodsId: "6919052157731391619",
discount: "0.17",
categoryName: "床上套件",
haiTao: 0,
cat2ndName: "床上用品",
cat1stName: "家纺布艺",
vipPrice: "229.00",
commission: "6.87",
cat1stId: 32532,
goodsName: "纯棉简约印花套件舒适亲肤四季款全棉床单被套床上用品三/四件套",
brandName: "博洋家纺",
brandLogoFull: http://a.vpimg3.com/upload/brandcool/0/1a3d613045d344dca6ad21dcc3f0d781/10000335/primary.png,
couponInfo: {useEndTime: 1617156000000,
totalAmount: 1000000,
couponName: "20元优惠券",
activateEndTime: 1617156000000,
buy: "20.00",
useBeginTime: 1616464801000,
couponNo: "1471162",
fav: "20.00",
activateBeginTime: 1616464800000,
activedAmount: 5728
},
brandStoreSn: "10000335",
sellTimeFrom: 1537860217000,
schemeStartTime: 1616205600000,
schemeEndTime: 2145888000000,
sourceType: 0,
sellTimeTo: 1735660800000,
brandId: 1710613859,
goodsThumbUrl: https://a.vpimg3.com/upload/merchandise/pdcvis/100287/2020/0902/31/05b4b7e4-077d-4f42-84de-318d0929b6c0_750x750_50.jpg,
cat2ndId: 441,
spuId: "SPU-0943981A80080177",
storeInfo: {storeName: "唯品自营",
storeId: "ST00000"
},
goodsMainPicture: https://a.vpimg2.com/upload/merchandise/pdcvis/100287/2020/0902/31/05b4b7e4-077d-4f42-84de-318d0929b6c0.jpg,
destUrl: https://m.vip.com/product-1710613859-6919052157731391619.html,
categoryId: 390875,
status: 1
},
{marketPrice: "230.00",
commissionRate: "1",
goodsId: "6918503738539615059",
discount: "0.27",
categoryName: "护体乳",
haiTao: 0,
cat2ndName: "身体护理",
cat1stName: "个人护理",
vipPrice: "45.00",
commission: "0.45",
cat1stId: 7470,
goodsName: "【樱香萦绕】樱花烟酰胺身体乳女润肤持久留香滋润香体补水保湿",
brandName: "半亩花田",
brandLogoFull: http://a.vpimg3.com/upload/brandcool/0/82b72f7239234bc681e6c113e93ea53c/10038705/primary.png,
couponInfo: {useEndTime: 1617069600000,
totalAmount: 1000000,
couponName: "半亩花田美妆节5元优惠券",
activateEndTime: 1617069600000,
buy: "5.00",
useBeginTime: 1616464800000,
couponNo: "1463945",
fav: "5.00",
activateBeginTime: 1616464800000,
activedAmount: 25727
},
brandStoreSn: "10038705",
sellTimeFrom: 1566526700000,
schemeStartTime: 1616205600000,
schemeEndTime: 2145888000000,
sourceType: 0,
sellTimeTo: 1735660800000,
brandId: 1710960147,
goodsThumbUrl: https://a.vpimg2.com/upload/merchandise/pdcvis/616365/2021/0323/32/959d3199-ec95-4d3d-9f59-464228bcd35e_750x750_50.jpg,
cat2ndId: 1021,
spuId: "SPU-06E5CC98800003F7",
storeInfo: {storeName: "唯品自营",
storeId: "ST00000"
},
goodsMainPicture: https://a.vpimg4.com/upload/merchandise/pdcvis/616365/2021/0323/32/959d3199-ec95-4d3d-9f59-464228bcd35e.jpg,
destUrl: https://m.vip.com/product-1710960147-6918503738539615059.html,
categoryId: 390723,
status: 1
}
]
}

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

请查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完，请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】，检查您的推广位PID是否填写，或是否填写正确。

4015

系统异常

服务端处理异常，请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝，您的账号状态存在异常，请联系平台管理员解除限制。

首页

关于

联系我们