文档
测试

单品详情

GET
https://tao.leecs.cn/api/goods/get-goods-details

请求参数

参数名
类型
描述
必填
appKey
String
唯一验证(应用分配的appKey)
必填
version
String
API接口版本号(v1.1.1)
必填
id
Number
商品id(平台商品id,请求时id或goodsId必填其中一个,若均填写,将优先查找当前单品id)
必填
goodsId
String
【非必输】淘宝商品id(id或goodsId必填其中一个,若均填写,将优先查找当前单品id)
必填

响应参数

参数名
类型
描述
必填
id
number
示例:22777171 商品id,若查询结果id=-1,则说明该商品非平台商品,数据为淘宝直接返回的数据,由于淘宝数据的缓存时间相对较长,会出现商品信息和详情信息不一致的情况
必填
goodsId
string
淘宝商品id 示例:576997447689
必填
itemLink
String
商品淘宝链接(“https://detail.tmall.com/item.htm?id=589284195570“)
必填
title
String
淘宝标题
必填
dtitle
String
平台短标题
必填
desc
String
推广文案
必填
cid
Number
商品在平台的分类id
必填
subcid
List[Number]
商品在平台的二级分类id,该分类为前端分类,一个商品可能有多个二级分类id
必填
tbcid
Number
商品在淘宝的分类id
必填
mainPic
String
商品主图链接(“//img.alicdn.com/imgextra/i2/4014489195/O1CN01kYlVPs2HnMKYwLLRm_!!4014489195.jpg”)
必填
marketingMainPic
String
营销主图链接(“https://sr.ffquan.com/super_pic/o_1d6fpckjs1ii3h9dkibk9b7h38.jpg“)
必填
originalPrice
Number
商品原价
必填
actualPrice
number
券后价
必填
discounts
Number
折扣力度
必填
couponLink
String
优惠券链接(“https://uland.taobao.com/quan/detail?sellerId=4014489195&activityId=df6c5ba6aa6d4f21a303b50cca2f4a45“)
必填
couponTotalNum
Number
券总量
必填
couponReceiveNum
Number
领券量
必填
couponEndTime
String
优惠券结束时间
必填
couponStartTime
String
优惠券开始时间
必填
couponPrice
Number
优惠券金额
必填
couponConditions
String
优惠券使用条件
必填
monthSales
Number
30天销量
必填
twoHoursSales
Number
2小时销量
必填
dailySales
Number
当天销量
必填
brand
Number
是否是品牌商品
必填
brandId
Number
品牌id
必填
brandName
String
品牌名称
必填
createTime
String
商品上架时间
必填
tchaoshi
Number
是否天猫超市商品,1-天猫超市商品,0-非天猫超市商品
必填
activityType
Number
活动类型,1-无活动,2-淘抢购,3-聚划算
必填
activityStartTime
String
活动开始时间
必填
activityEndTime
String
活动结束时间
必填
shopType
Number
店铺类型,1-天猫,0-淘宝
必填
goldSellers
Number
是否金牌卖家,1-金牌卖家,0-非金牌卖家
必填
haitao
Number
是否海淘,1-海淘商品,0-非海淘商品
必填
sellerId
String
淘宝卖家id(“4014489195”)
必填
shopName
String
店铺名称
必填
shopLevel
Number
淘宝店铺等级
必填
descScore
Number
描述分
必填
dsrScore
Number
描述相符
必填
dsrPercent
Number
描述同行比
必填
shipScore
Number
物流服务
必填
shipPercent
Number
物流同行比
必填
serviceScore
Number
服务态度
必填
servicePercent
Number
服务同行比
必填
hotPush
Number
热推值
必填
detailPics
Array
商品主图(需要做适配)([{“img”: “//img.alicdn.com/imgextra/i2/2099112387/O1CN015iPsj11TVHwGWKgLO!!2099112387.jpg”}, {“img”: “//img.alicdn.com/imgextra/i2/2099112387/O1CN01JjrEDb1TVHvlYyOMQ!!2099112387.jpg”}])
必填
imgs
Array
淘宝轮播图
必填
reimgs
Array
相关商品图
必填
quanMLink
Number
定金,若无定金,则显示0
必填
hzQuanOver
Number
立减,若无立减金额,则显示0
必填
yunfeixian
Number
0.不包运费险 1.包运费险
必填
estimateAmount
Number
预估淘礼金
必填

说明 / 示例

{ "time": 1571298654642, "code": 0, "msg": "成功", "data": { "id": 22777171, "goodsId": "576997447689", "title": "麦德好果仁雪花酥网红零食小吃糕点休闲食品饼干整箱牛轧糖沙琪玛", "dtitle": "【麦德好】蔓越莓果仁雪花酥400g", "originalPrice": 9.9, "actualPrice": 6.9, "shopType": 1, "goldSellers": 0, "monthSales": 49071, "twoHoursSales": 6922, "dailySales": 14713, "commissionType": 3, "desc": "【买一送一共发400g】新西兰进口奶源,精选原材料手工制作,奶香味十足,酥脆爽口,甜而不腻,每一口都是好滋味【七天无理由退换,破损包退,赠运费险】", "couponReceiveNum": 8000, "couponLink": "https://uland.taobao.com/quan/detail?sellerId=1791258654&activityId=c1ccb9f537ae4704aa27fbce96d8809e", "couponEndTime": "2019-10-19 23:59:59", "couponStartTime": "2019-10-17 00:00:00", "couponPrice": 3.0, "couponConditions": "9", "activityType": 3, "createTime": "2019-10-16 23:37:02", "mainPic": "https://img.alicdn.com/imgextra/i3/1791258654/O1CN01XRU1jH2Dna7Kan4Lj_!!1791258654.jpg", "marketingMainPic": "https://sr.ffquan.cn/relate_pic/o_1dnbluh3v1acepcvtae1l0kpd418.jpg", "sellerId": "1791258654", "cid": 6, "discounts": 0.7, "commissionRate": 25.0, "couponTotalNum": 100000, "haitao": 0, "activityStartTime": "2019-10-17 10:00:00", "activityEndTime": "2019-10-20 08:59:59", "shopName": "食尚物语食品专营店", "shopLevel": 20, "descScore": 4.8, "brand": 0, "brandId": 31978674, "brandName": "麦德好", "hotPush": 1001, "teamName": "牛犇-商盟", "itemLink": "https://detail.tmall.com/item.htm?id=576997447689", "tchaoshi": 0, "detailPics": "//img.alicdn.com/imgextra/i3/1791258654/O1CN01Cy0yax2Dna3OlR1q8_!!1791258654.jpg,//img.alicdn.com/imgextra/i2/1791258654/O1CN01qrVtiZ2Dna74t1liN_!!1791258654.jpg,//img.alicdn.com/imgextra/i1/1791258654/O1CN013QFTJa2Dna70My64y_!!1791258654.jpg,//img.alicdn.com/imgextra/i1/1791258654/O1CN01VL9GjZ2Dna752iDix_!!1791258654.jpg,//img.alicdn.com/imgextra/i4/1791258654/O1CN010C2o1h2Dna76JYU8I_!!1791258654.jpg,//img.alicdn.com/imgextra/i2/1791258654/O1CN01zwZeqR2Dna75nXBSu_!!1791258654.jpg,//img.alicdn.com/imgextra/i1/1791258654/O1CN01oidoKY2Dna74JaBdB_!!1791258654.jpg,//img.alicdn.com/imgextra/i4/1791258654/O1CN01DECkeD2Dna7O0yemi_!!1791258654.jpg,//img.alicdn.com/imgextra/i3/1791258654/O1CN0132Lpqk2Dna7GxnEz3_!!1791258654.jpg,//img.alicdn.com/imgextra/i3/1791258654/O1CN01L3e0WO2Dna7Q7FHK9_!!1791258654.jpg", "dsrScore": 4.8, "dsrPercent": 17.17, "shipScore": 4.8, "shipPercent": 0.0, "serviceScore": 4.8, "servicePercent": 2.51, "subcid": [8395, 90318], "imgs": "https://img.alicdn.com/imgextra/i1/1791258654/O1CN01dbvK0R2Dna7Oofw0k_!!0-item_pic.jpg,https://img.alicdn.com/imgextra/i3/1791258654/O1CN01XRU1jH2Dna7Kan4Lj_!!1791258654.jpg,https://img.alicdn.com/imgextra/i1/1791258654/O1CN01h2wUZy2Dna7EzKNeL_!!1791258654.jpg,https://img.alicdn.com/imgextra/i2/1791258654/O1CN01kVLBAz2Dna7FDDVqS_!!1791258654.jpg,https://img.alicdn.com/imgextra/i4/1791258654/O1CN01uq8HT72Dna7NdRRq4_!!1791258654.png", "reimgs": "", "tbcid": 50010513, "quanMLink":10, "hzQuanOver":100, "yunfeixian":1, "estimateAmount":0 } } --- 失败 { "msg":"服务器错误", "code":-1, "time":1554365022200 } --- 错误码编码 错误码信息 解决问题办法 -1 服务器错误 稍后尝试访问 1 参数错误 请根据msg提示信息进行修改 10007 参数错误 开始时间必须小于或等于结束时间