唯品会商品详情信息接口v2.0版
需要授权
510人使用

根据指定商品ID查询商品详细信息

(1)商品集合最大个数为10

(2)支持是否返回商品头图和详情图,库存,口碑(点评),店铺,参与的活动,预付信息

(3)支持是否扩展查询同spu下其它商品信息


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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

goodsIds

List<String>

6918663350057259160,6919027175172422552

商品id列表,最多不超过10个

queryDetail

Boolean

是否查询详情信息:此参数设为true,将查询出商品轮播图和详情图,默认为false

queryStock

Boolean

是否查询商品库存状态:默认为false

queryReputation

Boolean

是否查询商品评价信息:默认为false

queryStoreServiceCapability

Boolean

是否查询商品所属店铺服务能力信息:默认为false

queryPMSAct

Boolean

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

queryPrepay

Boolean

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

chanTag

String

用户pid

extendBySpu

Boolean

是否按照同spu扩展:此参数为true时,将根据传入的商品id扩展查询出同spu下的所有商品id,默认为false

queryExclusiveCoupon

Boolean

是否查询渠道专属红包信息: 默认不查询

extendSku

Boolean

是否扩展查询商品sku信息: 此参数为true时,将根据传入的商品id扩展查询出对应的sku信息,默认为false。指定此参数查询较耗时,建议单个查询,并且业务上避免重复查询场景

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:全国仓

queryCpsInfo

Integer

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

返回参数说明

标记

类型

例子

说明

goodsId

String

商品id

goodsName

String

商品名称

destUrl

String

商品落地页

goodsThumbUrl

String

商品缩略图

goodsCarouselPictures

List<String>

商品轮播图

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>

商品详情图片

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

commentsInfo

商品评价信息

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

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

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

goodsIdsWithSameSpu

List<String>

同spuId扩展商品id: 新版详情接口返回,其余接口不返回该字段

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

市场价:单位元

exclusiveCoupon

exclusiveCoupon

exclusiveCoupon

couponNo

String

优惠券批次号

couponName

String

优惠劵名称

fav

String

优惠金额:单位-元

buy

String

使用门槛:单位-元

activateBeginTime

Long

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

activateEndTime

Long

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

useBeginTime

Long

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

useEndTime

Long

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

totalAmount

Long

生成劵的总量

activedAmount

Long

劵已激活的数量

receiveUrl

String

专属领券页地址

cpsInfo

Map<Integer, String>

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

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":[
        {
            "marketPrice":"599.00",
            "commissionRate":"10",
            "goodsId":"6918663350057259160",
            "discount":"0.70",
            "goodsCarouselPictures":[
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/170/da4d5a87-abb0-4c05-8961-3a5547a4b601_750x750_75.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/609504/2019/1111/121/7147d93c-2ddb-4f46-9032-813d091c3c57_750x750_75.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/609504/2019/1111/32/9a356f36-671a-404b-a3aa-04de92991a47_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/90/27cbac74-585d-4ac7-b2e2-1a04e608d7f2_750x750_75.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/1/e1bfcc5f-afc9-413f-bb98-fb9ce7700ccd_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/0914/32/260bee1c-5b40-4839-b16d-45fd960dfa1c_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/0914/186/dc052242-3530-4038-8575-6a52528793ad_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/0914/177/8afcff64-191d-41a2-9000-cb45670f2a22_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/0914/178/ab214d18-6718-4fd6-bd32-73a7355db4bb_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/0914/21/9446c1f5-b5a1-4c67-a93e-af5ff66a2671_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/0914/84/701a20c9-a071-4c34-b782-209052808cd7_750x750_75.jpg"
            ],
            "goodsDetailPictures":[
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/55/ae716faa-eeac-4035-b11f-186325be0355.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/105/ab040f3f-cb81-49a9-8b1d-6e90990a6158.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/618313/2020/1217/160/ae584f4b-777b-46d6-929f-9279b08912f2.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/79/409f6e26-d95f-463a-8be5-df5be9ce28f3.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/11/4043a179-69e9-46dc-a5e5-1211e59d38d7.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/37/af178a5a-18b9-41f9-8b9a-7c1e1f0af6ec.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/89/d925372c-1519-4044-93ff-07c8a17041f0.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/142/06cbece0-54ab-4750-b4e5-60830f650cc5.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/618313/2020/1217/74/afaa8e96-aebf-4125-9d34-5f615f3cb919.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/196/8f7cd72c-e3df-4167-975f-7ebd936894a8.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/28/108dc28d-10bd-4dd6-9534-b9fe5e075d9b.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/618313/2020/1217/167/8620f20f-533d-40ea-99d2-d458b45c2beb.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/126/d30f0af1-40e1-41c3-9630-1e0f39e86df2.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/67/627d145f-56fd-45b4-8792-94c9170e056b.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/618313/2020/1217/43/4e8b34a6-aa9f-4eaf-9654-564f1c8f5b6a.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/618313/2020/1217/156/78db2c0d-9fd4-4720-af6a-b41d8ab841dc.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/618313/2020/1217/181/067b20ee-7c3b-4947-8e30-9f50f5f8178d.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/191/c02863ef-8b1d-45d2-9545-886fbf729c85.jpg"
            ],
            "categoryName":"运动休闲鞋",
            "haiTao":0,
            "cat2ndName":"运动鞋",
            "cat1stName":"运动户外",
            "vipPrice":"399.00",
            "commission":"39.90",
            "cat1stId":1056,
            "goodsName":"【春季爆款】斯凯奇女鞋明星同款经典熊猫鞋老爹鞋女休闲鞋",
            "storeServiceCapability":{
                "storeScore":"98.00",
                "storeRankRate":"1.00"
            },
            "brandName":"斯凯奇",
            "brandLogoFull":"http://a.vpimg3.com/upload/brandcool/0/cb26a130bbc348f09fd99884636808a9/10000721/primary.png",
            "couponInfo":{
                "useEndTime":1617242400000,
                "totalAmount":1000000,
                "couponName":"斯凯奇体用红包",
                "activateEndTime":1617242400000,
                "buy":"40.00",
                "useBeginTime":1617069600000,
                "couponNo":"1504212",
                "fav":"40.00",
                "activateBeginTime":1616983200000,
                "activedAmount":2214
            },
            "brandStoreSn":"10000721",
            "skuInfos":[
                {
                    "sizeId":"6918663350057263256",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"39.5"
                    }
                },
                {
                    "sizeId":"6918663352314163352",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"38.5"
                    }
                },
                {
                    "sizeId":"6918663352701571224",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"40"
                    }
                },
                {
                    "sizeId":"6918663352752066712",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"38"
                    }
                },
                {
                    "sizeId":"6918663353307820184",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"36"
                    }
                },
                {
                    "sizeId":"6918663354149798040",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"41"
                    }
                },
                {
                    "sizeId":"6918663354991739032",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"36.5"
                    }
                },
                {
                    "sizeId":"6918663355985334424",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"37.5"
                    }
                },
                {
                    "sizeId":"6918663356119986328",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"37"
                    }
                },
                {
                    "sizeId":"6918663358999220376",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"35.5"
                    }
                },
                {
                    "sizeId":"6918663359925268632",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"39"
                    }
                },
                {
                    "sizeId":"6918663362518347928",
                    "marketPrice":"599",
                    "vipPrice":"399",
                    "saleProps":{
                        "134":"黑色/白色",
                        "453":"35"
                    }
                }
            ],
            "sellTimeFrom":1582345960000,
            "schemeStartTime":1617069600000,
            "commentsInfo":{
                "comments":1417,
                "goodCommentsShare":"94.00"
            },
            "schemeEndTime":1617156000000,
            "sourceType":0,
            "sellTimeTo":1735660800000,
            "brandId":1711197624,
            "goodsThumbUrl":"https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/170/da4d5a87-abb0-4c05-8961-3a5547a4b601_750x750_50.jpg",
            "cat2ndId":384271,
            "spuId":"SPU-080D92B880280167",
            "storeInfo":{
                "storeName":"唯品自营",
                "storeId":"ST00000"
            },
            "goodsMainPicture":"https://a.vpimg4.com/upload/merchandise/pdcvis/618313/2020/1217/170/da4d5a87-abb0-4c05-8961-3a5547a4b601.jpg",
            "destUrl":"https://m.vip.com/product-1711197624-6918663350057259160.html",
            "categoryId":384337,
            "status":0
        },
        {
            "marketPrice":"599.00",
            "commissionRate":"10",
            "goodsId":"6919027175172422552",
            "discount":"0.62",
            "goodsCarouselPictures":[
                "https://a.vpimg3.com/upload/merchandise/pdcvis/2020/10/29/165/2e252ce9-af69-44f1-b3cd-ac52a4e9582d_750x750_75.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/2020/10/29/8/ccbe23f7-ab0f-4e49-b331-ff59dd3db1d8_750x750_75.jpg",
                "https://a.vpimg4.com/upload/merchandise/pdcvis/2020/10/29/77/1e8e4830-6898-40e6-8f96-de4ee02ec815_750x750_75.jpg",
                "https://a.vpimg3.com/upload/merchandise/pdcvis/2020/10/29/170/3175647b-0624-4993-8166-2a6497a18d94_750x750_75.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/2020/10/29/50/c73b88ee-2009-4d6d-a5e2-6b4512e3174e_750x750_75.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/2020/10/29/33/f0559149-ad42-46a7-b2a7-81b4256515d8_750x750_75.jpg",
                "https://a.vpimg2.com/upload/merchandise/pdcvis/2020/10/29/17/5acc054d-4740-4788-810f-c4b86b5b158c_750x750_75.jpg"
            ],
            "goodsDetailPictures":[
                "https://a.vpimg3.com/upload/merchandise/pdcvis/2020/10/29/8/ccbe23f7-ab0f-4e49-b331-ff59dd3db1d8_750x750_50.jpg"
            ],
            "categoryName":"运动休闲鞋",
            "haiTao":0,
            "cat2ndName":"运动鞋",
            "cat1stName":"运动户外",
            "vipPrice":"278.00",
            "commission":"27.80",
            "cat1stId":1056,
            "goodsName":"斯凯奇JEREMYVILLE联名款女子时尚中帮帆布鞋",
            "storeServiceCapability":{
                "storeScore":"98.00",
                "storeRankRate":"1.00"
            },
            "brandName":"斯凯奇",
            "brandLogoFull":"http://a.vpimg3.com/upload/brandcool/0/cb26a130bbc348f09fd99884636808a9/10000721/primary.png",
            "brandStoreSn":"10000721",
            "skuInfos":[
                {
                    "sizeId":"6919027175172426648",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"36"
                    }
                },
                {
                    "sizeId":"6919027175846181784",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"39"
                    }
                },
                {
                    "sizeId":"6919027175862987672",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"37"
                    }
                },
                {
                    "sizeId":"6919027176098679704",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"38.5"
                    }
                },
                {
                    "sizeId":"6919027176115522456",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"36.5"
                    }
                },
                {
                    "sizeId":"6919027176132393880",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"35.5"
                    }
                },
                {
                    "sizeId":"6919027176149220248",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"38"
                    }
                },
                {
                    "sizeId":"6919027176182852504",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"35"
                    }
                },
                {
                    "sizeId":"6919027176670858136",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"37.5"
                    }
                },
                {
                    "sizeId":"6919027176721292184",
                    "marketPrice":"599",
                    "vipPrice":"278",
                    "saleProps":{
                        "134":"黑色",
                        "453":"40"
                    }
                }
            ],
            "sellTimeFrom":1582345960000,
            "schemeStartTime":1617069600000,
            "commentsInfo":{
                "comments":24,
                "goodCommentsShare":"100.00"
            },
            "schemeEndTime":1617156000000,
            "sourceType":0,
            "sellTimeTo":1735660800000,
            "brandId":1711197624,
            "goodsThumbUrl":"https://a.vpimg3.com/upload/merchandise/pdcvis/2020/10/29/8/ccbe23f7-ab0f-4e49-b331-ff59dd3db1d8_750x750_50.jpg",
            "cat2ndId":384271,
            "spuId":"SPU-0AA02100800000E7",
            "storeInfo":{
                "storeName":"唯品自营",
                "storeId":"ST00000"
            },
            "goodsMainPicture":"https://a.vpimg3.com/upload/merchandise/pdcvis/2020/10/29/8/ccbe23f7-ab0f-4e49-b331-ff59dd3db1d8.jpg",
            "destUrl":"https://m.vip.com/product-1711197624-6919027175172422552.html",
            "categoryId":384337,
            "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

请求拒绝

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