唯品会联盟商品列表信息接口
需要授权
1887人使用

获取联盟商品列表,支持指定排序字段 ,仅支持超高佣和出单爆款两个频道商品输出

如果调用接口出现 user has no union auth,requestId:genByGoodsIdWithOauth

下载“唯享客”app登录即可

精选组货码地址:https://www.dingdanxia.com/article/222.html

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

channelType

String

0

频道类型:channelType=0为高佣商品,channelType=1为销量排行榜,channelType=2为商家补贴佣金商品

page

Integer

1

页码

pageSize

Integer

20

分页大小:默认20,最大100

queryReputation

Boolean

是否查询商品评价信息:默认不查询,该数据在详情页有返回,没有特殊需求,建议不查询

queryStoreServiceCapability

Boolean

是否查询店铺服务能力信息:默认不查询,该数据在详情页有返回,没有特殊需求,建议不查询

sourceType

Integer

请求源类型:0-频道,1-组货

jxCode

String

精选组货码:当请求源类型为组货时必传

fieldName

String

排序字段: COMMISSION-佣金,PRICE-价格,COMM_RATIO-佣金比例,DISCOUNT-折扣

order

Integer

排序顺序:0-正序,1-逆序,默认正序

queryStock

Boolean

是否查询库存:默认不查询

queryActivity

Boolean

是否查询商品活动信息:默认不查询

queryPrepay

Boolean

是否查询商品预付信息:默认不查询

返回参数说明

标记

类型

例子

说明

goodsId

String

商品id

goodsName

String

商品名称

goodsDesc

String

商品描述,字段暂不输出

destUrl

String

商品落地页

goodsThumbUrl

String

商品缩略图

goodsCarouselPictures

List<String>

商品轮播图:根据商品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<String>

商品详情图片:根据商品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

店铺信息

L storeId

String

店铺id

L storeName

String

店铺名称

commentsInfo

GoodsCommentsInfo

商品评价信息

L comments

Integer

商品评论数

L goodCommentsShare

String

商品好评率:百分比,不带百分号

storeServiceCapability

StoreServiceCapability

商品所属店铺服务能力评价

L storeScore

String

店铺评分:保留两位小数

L storeRankRate

String

店铺同品类排名比例:例如10表示前10%

brandId

Long

商品所属档期(专场)id

schemeStartTime

Long

商品所属推广方案开始时间:时间戳,单位:毫秒

saleStockStatus

Integer

商品库存状态:1-已抢光,2-有库存,3-有机会,当列表查询库存或者查询商品详情时返回

status

Integer

商品状态:0-下架,1-上架

prepayInfo

PrepayInfo

商品预付信息

L isPrepay

Integer

是否预付商品:0-否,1-是

L prepayPrice

String

预付到手价:元

L firstAmount

String

预付首款金额:元

L lastAmount

String

预付尾款金额:元

L prepayFavAmount

String

预付优惠金额: 元

L deductionPrice

String

抵扣价格(首款+优惠金额):元

L prepayDiscount

String

预付折扣:(唯品价-优惠金额)/唯品价 保留两位小数的数字字符串

L prepayFirstStartTime

Long

首款支付开始时间:时间戳,单位毫秒

L prepayFirstEndTime

Long

首款支付结束时间:时间戳,单位毫秒

L prepayLastStartTime

Long

尾款支付开始时间:时间戳,单位毫秒

L prepayLastEndTime

Long

尾款支付结束时间:时间戳,单位毫秒

joinedActivities

List<ActivityInfo>

商品参与活动信息:未参与活动集合为空

L actType

Integer

活动类型:18-唯品快抢

L actName

String

活动名称

L beginTime

Long

开始时间:时间戳,单位毫秒

L endTime

Long

结束时间:时间戳,单位毫秒

L foreShowBeginTime

Long

预热开始时间:时间戳,单位毫秒

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 72,
	"data": [
	  {
		"marketPrice": "599.00",
		"commissionRate": "11",
		"goodsId": "6918661798452982548",
		"discount": "0.40",
		"categoryName": "女式牛仔裤~尚未启用",
		"cat2ndName": "女下装",
		"cat1stName": "女装",
		"vipPrice": "239.00",
		"commission": "26.29",
		"cat1stId": 311,
		"goodsName": "【2020春新款】荧光磨白破洞小脚翻边休闲牛仔裤",
		"brandName": "丽丽",
		"brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/55ff1056f02b4df28f3bad5c1d587cd4/10000547/primary.png",
		"brandStoreSn": "10000547",
		"sellTimeFrom": 1537857153000,
		"schemeStartTime": 1583805600000,
		"schemeEndTime": 1584324000000,
		"sourceType": 0,
		"sellTimeTo": 1735660800000,
		"brandId": 1710613684,
		"goodsThumbUrl": "https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/960169153-1971527585845714944-1971527585845714946-1_750x750_50.jpg",
		"cat2ndId": 330,
		"storeInfo": {
			"storeName": "唯品自营",
			"storeId": "ST00000"
		},
		"goodsMainPicture": "https://a.vpimg3.com/upload/merchandise/pdcvop/00100319/10000547/960169153-1971527585845714944-1971527585845714946-1.jpg",
		"destUrl": "https://m.vip.com/product-1710613684-6918661798452982548.html",
		"categoryId": 390566,
		"status": 1
	}, 
	  {
		"marketPrice": "649.00",
		"commissionRate": "11",
		"goodsId": "6918650442382242580",
		"discount": "0.38",
		"categoryName": "女式衬衫~尚未启用",
		"cat2ndName": "女上装",
		"cat1stName": "女装",
		"vipPrice": "249.00",
		"commission": "27.39",
		"cat1stId": 311,
		"goodsName": "【2020春新款】浪漫肖像印花宽松条纹全棉衬衫",
		"brandName": "丽丽",
		"brandLogoFull": "http://a.vpimg3.com/upload/brandcool/0/55ff1056f02b4df28f3bad5c1d587cd4/10000547/primary.png",
		"brandStoreSn": "10000547",
		"sellTimeFrom": 1537857153000,
		"schemeStartTime": 1583805600000,
		"schemeEndTime": 1584324000000,
		"sourceType": 0,
		"sellTimeTo": 1735660800000,
		"brandId": 1710613684,
		"goodsThumbUrl": "https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/1234386953-2614416430543781888-2614416430543785985-1_750x750_50.jpg",
		"cat2ndId": 312,
		"storeInfo": {
			"storeName": "唯品自营",
			"storeId": "ST00000"
		},
		"goodsMainPicture": "https://a.vpimg2.com/upload/merchandise/pdcvop/00100319/10000547/1234386953-2614416430543781888-2614416430543785985-1.jpg",
		"destUrl": "https://m.vip.com/product-1710613684-6918650442382242580.html",
		"categoryId": 390556,
		"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

请求拒绝

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