变更说明:
原接口返回数据中的lists字段调整为list,去掉了s,其他不变
参数 | 类型 | 请求参数参考值 | 是否必须 | 说明 |
apkey | String | xxxxxxx | 是 | 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
skuIds | String | 000000,11111 | skuIds集合,最大支持100个商品,可为空。如果传值,忽略其他查询条件。 | |
cid1 | String | xxxx | 一级类目id | |
cid2 | String | xxxx | 二级类目id | |
cid3 | String | xxxx | 三级类目id | |
keyword | String | xxxx | 商品关键词,字数同京东商品名称一致,目前未限制,可传入联盟推广链接查询指定商品 | |
pageIndex | String | 1 | 页码 | |
pageSize | String | 20 | 每页数量,单页数最大30,默认20 | |
pricefrom | String | 16.88 | 商品价格下限 | |
priceto | String | 19.88 | 商品价格上限 | |
commissionShareStart | String | 10 | 佣金比例区间开始 | |
commissionShareEnd | String | 50 | 佣金比例区间结束 | |
pageSize | String | Number | 每页数量,单页数最大30,默认20 | |
owner | String | g | 商品类型:自营[g],POP[p] | |
sortName | String | price | 排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30Days:30天引单量, inOrderComm30Days:30天支出佣金) | |
sort | String | desc | asc,desc升降序,默认降序 | |
isCoupon | String | 1 | 是否是优惠券商品,1:有优惠券,0:无优惠券 | |
isPG | String | 0 | 是否是拼购商品,1:拼购商品,0:非拼购商品 | |
pingouPriceStart | String | 16.88 | 拼购价格区间开始 | |
pingouPriceEnd | String | 19.88 | 拼购价格区间结束 | |
hasContent | String | 1 | 1:查询内容商品;其他值过滤掉此入参条件。 | |
brandCode | String | 7998 | 品牌code | |
shopId | String | 45619 | 店铺Id | |
hasBestCoupon | String | 1 | 1:查询有最优惠券商品;其他值过滤掉此入参条件。 | |
pid | String | 618_618_618 | 联盟id_应用iD_推广位id | |
fields | String | videoInfo | 支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息),hotWords(热词),similar(相似推荐商品),documentInfo(段子信息) | |
forbidTypes | String | 2,3,5 | 微信京东购物小程序禁售商品过滤规则,入参表示不展示该规则数据,支持多个逗号','分隔,2:OTC商品;3:加油卡;4:游戏充值卡;5:合约机;6:京保养;7:虚拟组套;8:定制商品 | |
jxFlags | String | 1,2 | 京喜商品类型,1京喜、2京喜工厂直供、3京喜优选(包含3时可在京东APP购买),入参多个值表示或条件查询,多个值需用,分割 | |
shopLevelFrom | String | 3.5 | 支持传入0.0、2.5、3.0、3.5、4.0、4.5、4.9,默认为空表示不筛选评分 |
返回参数 | 类型 | 参数说明 | 扩展说明 |
totalCount | Number | 请求到的总商品数 | |
list | Json | 商品列表 | |
├ categoryInfo | Json | 类目信息 | |
├ ├ cid1 | String | 一级类目ID | – |
├ ├ cid1Name | String | 一级类目名 | – |
├ ├ cid2 | String | 二级类目ID | – |
├ ├ cid2Name | String | 二级类目名 | – |
├ ├ cid3 | String | 三级类目ID | – |
├ ├ cid3Name | String | 三级类目名 | – |
├ commissionInfo | Json | 佣金信息 | |
├ ├ commission | String | 佣金 | – |
├ ├ commissionShare | String | 佣金比例 | 百分比,如显示25,则佣金比例为25% |
├ ├ couponCommission | String | 券后佣金 | 可能没有 |
├ ├ plusCommissionShare | String | plus佣金比例 | 可能没有 |
├ couponInfo | Json | 优惠券信息,返回内容为空说明该SKU无可用优惠券 | |
├ ├ couponList | String | 优惠券合集 | |
├ ├ ├ bindType | String | 券种类 | 优惠券种类:0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券 |
├ ├ ├ discount | String | 券面额 | – |
├ ├ ├ link | String | 券链接 | http://coupon.jd.com/ilink/couponActiveFront/front_index.action?XXXXXXX |
├ ├ ├ platformType | String | 券使用平台 | 平台类型:0 - 全平台券,1 - 限平台券 |
├ ├ ├ quota | String | 券消费限额 | – |
├ ├ ├ getStartTime | String | 领取开始时间 | 时间戳,毫秒值 |
├ ├ ├ getEndTime | String | 券领取结束时间 | 时间戳,毫秒值 |
├ ├ ├ useStartTime | String | 券有效使用开始时间 | 时间戳,毫秒值 |
├ ├ ├ useEndTime | String | 券有效使用结束时间 | 时间戳,毫秒值 |
├ ├ ├ isBest | String | 是否是最优优惠券 | 1=最优优惠券,0=其他 |
├ imageInfo | Json | 图片信息 | |
├ ├ imageList | Json | 图片合集 | |
├ ├ ├ url | String | 图片链接地址 | |
├ priceInfo | Json | 价格信息 | |
├ ├ price | String | 无线价格 | |
├ shopInfo | String | 店铺信息 | |
├ ├ shopName | String | 店铺名称(或供应商名称) | |
├ ├ shopId | String | 店铺ID | |
├ comments | String | 评论数 | – |
├ goodCommentsShare | String | 商品好评率 | – |
├ inOrderCount30Days | String | 30天引单数量 | – |
├ isJdSale | String | 是否自营 (1 : 是, 0 : 否),后续会废弃,请用owner | – |
├ materialUrl | String | 商品落地页 | – |
├ skuId | String | 商品ID | – |
├ skuName | String | 商品名称 | – |
├ isHot | String | 是否爆款 | 1:是,0:否 |
├ spuid | String | spuid,其值为同款商品的主skuid | – |
├ brandCode | String | 品牌code | – |
├ brandName | String | 品牌名 | – |
├ owner | String | g=自营,p=pop | – |
{"code":200,"data":{"list":[{"brandCode":"125969","brandName":"马提尼(MATINI)","categoryInfo":{"cid1":1315,"cid1Name":"服饰内衣","cid2":1342,"cid2Name":"男装","cid3":1349,"cid3Name":"T恤"},"comments":521,"commissionInfo":{"commission":9.8,"commissionShare":10},"couponInfo":{"couponList":[{"bindType":3,"discount":10,"getEndTime":1543589220000,"getStartTime":1542033960000,"link":"http://coupon.jd.com/ilink/couponSendFront/send_index.action?key=dd9466bc678144f29ce4fef256b349e6&roleId=15770907&to=mall.jd.com/index-144475.html","platformType":0,"quota":30,"useEndTime":1543593599000,"useStartTime":1541952000000}]},"goodCommentsShare":100,"imageInfo":{"imageList":[{"url":"http://img14.360buyimg.com/ads/jfs/t25189/117/2637028726/279670/dcc91ccc/5bed847dN6c0e4965.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t26731/182/1797118266/329846/e07e5f44/5bed824cNd3fa281a.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t29320/240/270303987/294753/758776ca/5bed80d9N19a6677d.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t29977/192/278598255/294223/a7d67001/5bed80d5Ne3741d18.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t28432/204/263546737/292293/1b827aab/5bed80d4N607364f8.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t26395/292/1774707104/301490/e5ef7a81/5bed80d4N7695d487.jpg"}]},"inOrderComm30Days":60.82,"inOrderCount30Days":20,"isHot":1,"isJdSale":0,"materialUrl":"item.jd.com/35250335411.html","owner":"p","pingGouInfo":{"pingouPrice":88,"pingouTmCount":2,"pingouUrl":"https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=35250335411&from=cps"},"planInfo":{"planList":[{"endTime":32472115200000,"planId":1535593346,"planType":1,"startTime":1542038400000}]},"priceInfo":{"price":98},"shopInfo":{"shopId":144475,"shopName":"马提尼旗舰店"},"skuId":35250335411,"skuName":"马提尼长袖T恤男针织衫加绒秋冬韩版修身学生男装潮上衣加厚保暖青少年衣服打底衫 宝蓝色常规(M145款) XL","spuid":35250327467}],"totalCount":2149},"msg":"数据获取成功."}
code/http_status | 说明 |
200 | 数据获取成功 |
-1 | 数据获取失败 |
401 | IP没有添加白名单 |
429 | 访问次数超限 |
403 | 关键参数丢失 |
405 | 请求方式不对 |