商品列表
GET
https://tao.leecs.cn/api/goods/get-goods-list
接口描述
首次获取全量商品时调用该接口
请求参数
参数名
类型
描述
必填
appKey
String
唯一验证
必填
version
String
API接口版本号(v1.1.1)
必填
pageSize
Number
每页条数(默认为100，最大值200，若小于10，则按10条处理，每页条数仅支持输入10,50,100,200)
必填
pageId
String
分页id(默认为1，支持传统的页码分页方式和scroll_id分页方式，根据用户自身需求传入值。示例1：商品入库，则首次传入1，后续传入接口返回的pageid，接口将持续返回符合条件的完整商品列表，该方式可以避免入口商品重复；示例2：根据pagesize和totalNum计算出总页数，按照需求返回指定页的商品（该方式可能在临近页取到重复商品）)
必填
sort
String
排序方式(默认为0，0-综合排序，1-商品上架时间从高到低，2-销量从高到低，3-领券量从高到低，4-佣金比例从高到低，5-价格（券后价）从高到低，6-价格（券后价）从低到高)
必填
cids
String
【非必输】一级类目id(一级分类id，如果需要传多个，以英文逗号相隔，如：”1,2,3”。当一级类目id和二级类目id同时传入时，会自动忽略二级类目id)
必填
subcid
Number
【非必输】二级类目id(二级类目id，通过超级分类API获取。仅允许传一个二级id，当一级类目id和二级类目id同时传入时，会自动忽略二级类目id)
必填
brand
Number
【非必输】是否品牌商品（1-品牌商品，0-所有商品，不填默认为0）
必填
brandIds
String
品牌id（当brand传入0时，再传入brandIds将获取不到结果。品牌id可以传多个，以英文逗号隔开，如：”345,321,323”）
必填
响应参数
参数名
类型
描述
必填
id
Number
商品id（18926311）
必填
goodsId
String
淘宝商品id
必填
itemLink
String
商品淘宝链接（“https://detail.tmall.com/item.htm?id=589284195570“）
必填
title
String
淘宝标题（“西维里男士睡衣夏季韩版真丝短袖丝绸薄款宽松青年冰丝家居服套装”）
必填
dtitle
String
短标题
必填
desc
String
推广文案（“宽松舒适，难以磨损典，雅而优美，倍感丝滑，质感优越，庄严而心仪，简约设计，色调清新脱俗，适合各种场合”）
必填
cid
Number
平台商品分类id（10）
必填
subcid
List[Number]
商品在平台的二级分类id，该分类为前端分类，一个商品可能有多个二级分类id（[86369,90723]）
必填
tbcid
Number
商品在淘宝的分类id（50012772）
必填
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
优惠券结束时间（“2019-04-08 23:59:59”）
必填
couponStartTime
String
优惠券开始时间（“2019-04-08 23:59:59”）
必填
couponPrice
Number
优惠券金额
必填
couponConditions
String
优惠券使用条件（“38”）
必填
monthSales
Number
30天销量（1030）
必填
twoHoursSales
Number
2小时销量
必填
dailySales
Number
当日销量
必填
brand
Number
是否是品牌商品
必填
brandId
Number
品牌id
必填
brandName
String
品牌名称
必填
createTime
String
商品上架时间（“2019-03-29 10:00:06”）
必填
activityType
Number
活动类型，1-无活动，2-淘抢购，3-聚划算
必填
activityStartTime
String
活动开始时间
必填
activityEndTime
String
活动结束时间
必填
shopType
Number
店铺类型，1-天猫，0-淘宝
必填
goldSellers
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
热推值
必填
quanMLink
Number
定金，若无定金，则显示0
必填
hzQuanOver
Number
立减，若无立减金额，则显示0
必填
yunfeixian
Number
0.不包运费险 1.包运费险
必填
estimateAmount
Number
预估淘礼金
必填