大牌搜索
GET
https://tao.leecs.cn/api/goods/get-dtk-search-goods
接口描述
根据搜索关键字及条件查询商品库中的商品，并返回符合条件的商品列表
请求参数
参数名
类型
描述
必填
appKey
String
唯一验证
必填
version
String
当前版本： v2.1.1
必填
pageSize
Number
每页条数（默认为100，最大值200，若小于10，则按10条处理，每页条数仅支持输入10,50,100,200）
必填
pageId
String
分页id（默认为1，支持传统的页码分页方式和scroll_id分页方式，根据用户自身需求传入值。示例1：商品入库，则首次传入1，后续传入接口返回的pageid，接口将持续返回符合条件的完整商品列表，该方式可以避免入口商品重复；示例2：根据pagesize和totalNum计算出总页数，按照需求返回指定页的商品（该方式可能在临近页取到重复商品））
必填
keyWords
String
关键词搜索
必填
cids
String
【非必输】一级类目Id（平台的一级分类id，如果需要传多个，以英文逗号相隔，如：”1,2,3”。当一级类目id和二级类目id同时传入时，会自动忽略二级类目id，一级分类id请求详情：1 -女装，2 -母婴，3 -美妆，4 -居家日用，5 -鞋品，6 -美食，7 -文娱车品，8 -数码家电，9 -男装，10 -内衣，11 -箱包，12 -配饰，13 -户外运动，14 -家装家纺）
必填
subcid
Number
【非必输】二级类目Id（平台的二级类目id，通过超级分类API获取。仅允许传一个二级id，当一级类目id和二级类目id同时传入时，会自动忽略二级类目id）
必填
brand
Number
【非必输】是否品牌商品（1-品牌商品，0-所有商品，不填默认为0）
必填
brandIds
String
【非必输】品牌id（当brand传入0时，再传入brandIds将获取不到结果。品牌id可以传多个，以英文逗号隔开，如：”345,321,323”）
必填
sort
String
【非必输】排序字段（默认为0，0-综合排序，1-商品上架时间从新到旧，2-销量从高到低，3-领券量从高到低，4-佣金比例从高到低，5-价格（券后价）从高到低，6-价格（券后价）从低到高）
必填
响应参数
参数名
类型
描述
必填
id
Number
商品id
必填
goodsId
String
淘宝商品id
必填
title
String
淘宝标题
必填
dtitle
String
短标题
必填
originalPrice
Number
商品原价
必填
actualPrice
Number
券后价
必填
shopType
Number
店铺类型，1-天猫，0-淘宝
必填
goldSellers
Number
是否金牌卖家，1-金牌卖家，0-非金牌卖家
必填
monthSales
Number
30天销量
必填
twoHoursSales
Number
2小时销量
必填
dailySales
Number
当天销量
必填
desc
String
推广文案
必填
couponReceiveNum
Number
领券量
必填
couponLink
String
优惠券链接
必填
couponEndTime
String
优惠券结束时间
必填
couponStartTime
String
优惠券开始时间
必填
couponPrice
Number
优惠券金额
必填
couponConditions
String
优惠券使用条件
必填
activityType
Number
活动类型，1-无活动，2-淘抢购，3-聚划算
必填
createTime
String
商品上架时间
必填
mainPic
String
商品主图链接
必填
sellerId
String
淘宝卖家id
必填
cid
Number
商品在平台的分类id
必填
subcid
List[Number]
商品在平台的二级分类id，该分类为前端分类，一个商品可能有多个二级分类id（[86369,90723]）
必填
tbcid
Number
商品在淘宝的分类id
必填
discounts
Number
折扣力度
必填
couponTotalNum
Number
券总量
必填
activityStartTime
String
活动开始时间
必填
activityEndTime
String
活动结束时间
必填
shopName
String
店铺名称
必填
shopLevel
Number
淘宝店铺等级
必填
descScore
Number
描述分
必填
dsrScore
Number
描述相符
必填
dsrPercent
Number
描述同行比
必填
shipPercent
Number
物流同行比
必填
serviceScore
Number
服务态度
必填
servicePercent
Number
服务同行比
必填
brand
Number
是否是品牌商品
必填
brandId
Number
品牌id
必填
brandName
String
品牌名称
必填
dailySales
Number
当日销量
必填
hotPush
Number
热推值
必填
itemLink
String
商品淘宝链接
必填
reimgs
Array
相关商品图
必填
quanMLink
Number
定金，若无定金，则显示0
必填
hzQuanOver
Number
立减，若无立减金额，则显示0
必填
yunfeixian
Number
0.不包运费险 1.包运费险
必填
estimateAmount
Number
预估淘礼金
必填