唯品会猜你喜欢商品列表
需要授权
1887人使用

根据用户信息个性化推荐商品
接口最多返回40个商品,可能返回极少或不返回商品,渠道需做好兼容

接口地址: http://api.tbk.dingdanxia.com/vip/user_recommend 在线测试

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

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

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

请求拒绝

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