唯品会相似推荐商品列表
需要授权
1020人使用

根据商品ID查询相似推荐商品

接口最多返回40个商品,可能返回极少或不返回商品,渠道需做好兼容




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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

goodsId

String

6918678109584504971

商品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加密后的值,有则传入

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参数+小程序链接

返回参数说明

标记

类型

例子

说明

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": 22,
	"data": [{
			"marketPrice": "1119.00",
			"commissionRate": "3",
			"goodsId": "6918997109641747267",
			"discount": "0.25",
			"categoryName": "床上套件",
			"haiTao": 0,
			"cat2ndName": "床上用品",
			"cat1stName": "家纺布艺",
			"vipPrice": "269.00",
			"commission": "8.07",
			"cat1stId": 32532,
			"goodsName": "纯棉床上用品小清新可爱印花套件舒适亲肤全棉床单被套三/四件套",
			"brandName": "博洋家纺",
			"brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/1a3d613045d344dca6ad21dcc3f0d781/10000335/primary.png",
			"couponInfo": {
				"useEndTime": 1617156000000,
				"totalAmount": 1000000,
				"couponName": "30元优惠券",
				"activateEndTime": 1617156000000,
				"buy": "30.00",
				"useBeginTime": 1616464801000,
				"couponNo": "1471163",
				"fav": "30.00",
				"activateBeginTime": 1616464800000,
				"activedAmount": 3837
			},
			"brandStoreSn": "10000335",
			"sellTimeFrom": 1537860217000,
			"schemeStartTime": 1616205600000,
			"schemeEndTime": 2145888000000,
			"sourceType": 0,
			"sellTimeTo": 1735660800000,
			"brandId": 1710613859,
			"goodsThumbUrl": "https://a.vpimg2.com/upload/merchandise/pdcvis/100287/2020/1009/5/db9094a2-373b-4956-b8a3-013d885057a0_750x750_50.jpg",
			"cat2ndId": 441,
			"spuId": "SPU-0A6E38D0801007B7",
			"storeInfo": {
				"storeName": "唯品自营",
				"storeId": "ST00000"
			},
			"goodsMainPicture": "https://a.vpimg2.com/upload/merchandise/pdcvis/100287/2020/1009/5/db9094a2-373b-4956-b8a3-013d885057a0.jpg",
			"destUrl": "https://m.vip.com/product-1710613859-6918997109641747267.html",
			"categoryId": 390875,
			"status": 1
		},
		{
			"marketPrice": "829.00",
			"commissionRate": "3",
			"goodsId": "6919054630163855491",
			"discount": "0.23",
			"categoryName": "床上套件",
			"haiTao": 0,
			"cat2ndName": "床上用品",
			"cat1stName": "家纺布艺",
			"vipPrice": "189.00",
			"commission": "5.67",
			"cat1stId": 32532,
			"goodsName": "纯棉清新ins印花套件舒适亲肤全棉床单被套床上用品三/四件套",
			"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": 5730
			},
			"brandStoreSn": "10000335",
			"sellTimeFrom": 1537860217000,
			"schemeStartTime": 1616205600000,
			"schemeEndTime": 2145888000000,
			"sourceType": 0,
			"sellTimeTo": 1735660800000,
			"brandId": 1710613859,
			"goodsThumbUrl": "https://a.vpimg4.com/upload/merchandise/pdcvis/100287/2020/1030/119/15078ba6-3f28-4270-a81f-1c8079107398_750x750_50.jpg",
			"cat2ndId": 441,
			"spuId": "SPU-0826E850800001FF",
			"storeInfo": {
				"storeName": "唯品自营",
				"storeId": "ST00000"
			},
			"goodsMainPicture": "https://a.vpimg2.com/upload/merchandise/pdcvis/100287/2020/1030/119/15078ba6-3f28-4270-a81f-1c8079107398.jpg",
			"destUrl": "https://m.vip.com/product-1710613859-6919054630163855491.html",
			"categoryId": 390875,
			"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

请求拒绝

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