淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
考拉海购
点击获取APKEY

正常 京粉精选商品查询接口

更新时间:2020-11-04 20:47:00

请求链接: http://api.web.ecapi.cn/jingdong/getJfItems
请求实例: http://api.web.ecapi.cn/jingdong/getJfItems?apkey=登录会员中心查看&eliteId=1&pageIndex=1&pageSize=20 (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 京粉精选商品查询接口
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

原接口数据格式:

{"code":200,"data":[{"brandCode":"282254","brandName":"泉兮(QUARXERY)","categoryInfo":{"cid1":1316,"cid1Name":"美妆护肤","cid2":1381,"cid2Name":"面部护肤","cid3":1391,"cid3Name":"乳液/面霜"},"comments":5934,"commissionInfo":{"commission":14.45,"commissionShare":50},"couponInfo":{"couponList":[{"bindType":3,"discount":19,"getEndTime":1554016620000,"getStartTime":1553584560000,"link":"http://coupon.m.jd.com/coupons/show.action?key=38af97177ebb4ce6be89c123aa0474c1&roleId=18515087&to=item.jd.com/40895480257.html","platformType":0,"quota":28,"useEndTime":1554134399000,"useStartTime":1553529600000}]},"goodCommentsShare":99,"imageInfo":{"imageList":[{"url":"http://img14.360buyimg.com/ads/jfs/t1/22899/8/6084/173596/5c4722c4E1bf04c83/61240b4215e02e3f.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/10517/16/8130/168475/5c32bfd3Eb8a5ebe1/21a2f880480575db.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/12157/7/4634/135498/5c32bfd3Ef008fc84/76597a299b453ecd.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/19255/14/4507/157416/5c331e8fE196487de/221595b7ef2a218d.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/21356/6/4502/124456/5c32bfd4Ea4ead949/897773daae481c00.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/18356/3/4501/160768/5c32bfd3E0234ee99/b95a289cb48b5212.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/27533/28/4615/128093/5c32bfd3E943a62c0/546c9cedd9b3669c.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/24719/27/4530/148014/5c331e8fE872d213a/2d7258e98e3c5bcc.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/19642/38/4446/143900/5c32bfd4E9a0b4bc4/56b8f270423e79a6.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t1/21293/34/4679/160180/5c340a68E80d49178/718a6b8aca64ba8b.jpg"}]},"inOrderCount30Days":3945,"inOrderCount30DaysSku":3945,"isHot":1,"materialUrl":"item.jd.com/40895480257.html","owner":"p","pinGouInfo":[],"priceInfo":{"price":28.9},"resourceInfo":{"eliteId":1,"eliteName":"好券商品"},"shopInfo":{"shopId":770292,"shopName":"盖茨比个护专营店"},"skuId":40895480257,"skuName":"【第2件1元】芦荟胶祛痘膏祛痘印淡化去痘坑补水舒缓晒后修复男女保湿面霜面膜","spuid":40895480257}],"totalCount":197,"msg":"数据获取成功."}

重构版数据格式:

{"code":200,"data":{"list":[{"brandCode":"102747","brandName":"左薇莎(JOWISSA)","categoryInfo":{"cid1":5025,"cid1Name":"钟表","cid2":5026,"cid2Name":"腕表","cid3":13673,"cid3Name":"瑞表"},"comments":102,"commissionInfo":{"commission":792,"commissionShare":40},"couponInfo":{"couponList":[{"bindType":3,"discount":400,"getEndTime":1577807999000,"getStartTime":1573747200000,"isBest":1,"link":"http://coupon.m.jd.com/coupons/show.action?key=bf8a72e9516c4309bdfbe28455b4f7d1&roleId=25330913&to=zuoweisha.jd.com","platformType":0,"quota":1980}]},"goodCommentsShare":95,"imageInfo":{"imageList":[{"url":"http://img14.360buyimg.com/ads/jfs/t1/44314/2/11550/139622/5d4bb236E9af39b88/1c307256dd24889c.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3616/336/1222033023/196916/b985b8a7/58204470N83dfabc1.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3280/357/4521545020/242568/33c405d7/584e49d8Nf36f444f.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3976/43/431784860/229225/6a742fc/584e49ddN3a341097.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3742/180/2309189027/205487/a5e2db63/584e49e1N8354c575.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3508/202/2411616514/319919/df46b6cf/584e49e6Nf76f2ce8.jpg"}]},"inOrderCount30Days":17,"inOrderCount30DaysSku":9,"isHot":1,"materialUrl":"item.jd.com/10122987694.html","owner":"p","pinGouInfo":[],"priceInfo":{"price":1980},"resourceInfo":{"eliteId":1,"eliteName":"好券商品"},"shopInfo":{"shopId":116427,"shopName":"左薇莎旗舰店"},"skuId":10122987694,"skuName":"左薇莎(Jowissa) 瑞士原装进口手表 男士腕表 计时闹铃多功能石英表 夜光超薄防水 时尚休闲 黑色-表盘40MM-J7.006.L","spuid":10122987692}],"totalCount":197},"msg":"success"}

变更说明:

将原商品列表移至list字段下,同时将list与totalCount一起移至data字段下


请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
eliteIdNumber1频道ID:1-好券商品,2-精选卖场,10-9.9包邮,15-京东配送,22-实时热销榜,23-为你推荐,24-数码家电,25-超市,26-母婴玩具,27-家具日用,28-美妆穿搭,30-图书文具,31-今日必推,32-京东好物,33-京东秒杀,34-拼购商品,40-高收益榜,41-自营热卖榜,109-新品首发,110-自营,112-京东爆品,125-首购商品,129-高佣榜单,130-视频商品,153-历史最低价商品榜
pageIndexNumber1页码
pageSizeNumber20每页数量,上限50
sortNameStringprice排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30DaysSku:sku维度30天引单量,comments:评论数,goodComments:好评数)
sortStringdescasc,desc升降序,默认降序
fieldsStringvideoInfo,documentInfo支持出参数据筛选,逗号','分隔,目前可用:videoInfo,documentInfo
forbidTypesString10微信京东购物小程序禁售,11微信京喜小程序禁售

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据
 ├ listJson商品数据
 ├  ├ categoryInfoJson类目信息
 ├  ├  ├ cid1Number一级类目ID
 ├  ├  ├ cid1NameString一级类目名称
 ├  ├  ├ cid2Number二级类目ID
 ├  ├  ├ cid2NameString二级类目名称
 ├  ├  ├ cid3Number三级类目ID
 ├  ├  ├ cid3NameString三级类目名称
 ├  ├ commentsNumber评论数
 ├  ├ commissionInfoJson佣金信息
 ├  ├  ├ commissionNumber佣金参考
 ├  ├  ├ commissionShareNumber佣金比例如数据为50,则佣金比例为50%
 ├  ├ couponInfoNumber优惠券信息返回内容为空说明该SKU无可用优惠券
 ├  ├  ├ couponListJson优惠券合集
 ├  ├  ├  ├ bindTypeNumber券种类优惠券种类:0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券
 ├  ├  ├  ├ discountNumber券面额
 ├  ├  ├  ├ linkString券链接
 ├  ├  ├  ├ platformTypeString券使用平台0 - 全平台券,1 - 限平台券
 ├  ├  ├  ├ quotaNumber券消费限额
 ├  ├  ├  ├ getStartTimeString领取开始时间时间戳,毫秒
 ├  ├  ├  ├ getEndTimeNumber券领取结束时间时间戳,毫秒
 ├  ├  ├  ├ useStartTimeNumber券有效使用开始时间时间戳,毫秒
 ├  ├  ├  ├ useEndTimeNumber券有效使用结束时间时间戳,毫秒
 ├  ├ goodCommentsShareString商品好评率
 ├  ├ imageInfoJson图片信息
 ├  ├  ├ imageListJson图片合集
 ├  ├  ├  ├ urlString图片链接地址,第一个图片链接为主图链接
 ├  ├ inOrderCount30DaysNumber30天引单数量
 ├  ├ materialUrlString商品落地页
 ├  ├ priceInfoJson价格信息
 ├  ├  ├ priceNumber无线价格
 ├  ├ shopInfoJson店铺信息
 ├  ├  ├ shopNameString店铺名称(或供应商名称)
 ├  ├  ├ shopIdNumber店铺Id
 ├  ├ skuIdNumber商品ID
 ├  ├ skuNameString商品名称
 ├  ├ isHotNumber是否爆款1:是,0:否
 ├  ├ spuidNumberspuid,其值为同款商品的主skuid
 ├  ├ brandCodeString品牌code
 ├  ├ brandNameString品牌名
 ├  ├ ownerStringg=自营,p=pop
 ├  ├ pinGouInfoJson拼购信息
 ├  ├  ├ pingouPriceString拼购价格
 ├  ├  ├ pingouTmCountNumber拼购成团所需人数
 ├  ├  ├ pingouUrlString拼购落地页url
 ├  ├ resourceInfoJson资源信息
 ├  ├  ├ eliteIdNumber频道id
 ├  ├  ├ eliteNameString频道名称
 ├  ├ inOrderCount30DaysSkuNumber30天引单数量(sku维度)
 ├ totalCountNumber有效商品总数量

Json返回示例

{"code":200,"data":{"list":[{"brandCode":"102747","brandName":"左薇莎(JOWISSA)","categoryInfo":{"cid1":5025,"cid1Name":"钟表","cid2":5026,"cid2Name":"腕表","cid3":13673,"cid3Name":"瑞表"},"comments":102,"commissionInfo":{"commission":792,"commissionShare":40},"couponInfo":{"couponList":[{"bindType":3,"discount":400,"getEndTime":1577807999000,"getStartTime":1573747200000,"isBest":1,"link":"http://coupon.m.jd.com/coupons/show.action?key=bf8a72e9516c4309bdfbe28455b4f7d1&roleId=25330913&to=zuoweisha.jd.com","platformType":0,"quota":1980}]},"goodCommentsShare":95,"imageInfo":{"imageList":[{"url":"http://img14.360buyimg.com/ads/jfs/t1/44314/2/11550/139622/5d4bb236E9af39b88/1c307256dd24889c.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3616/336/1222033023/196916/b985b8a7/58204470N83dfabc1.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3280/357/4521545020/242568/33c405d7/584e49d8Nf36f444f.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3976/43/431784860/229225/6a742fc/584e49ddN3a341097.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3742/180/2309189027/205487/a5e2db63/584e49e1N8354c575.jpg"},{"url":"http://img14.360buyimg.com/ads/jfs/t3508/202/2411616514/319919/df46b6cf/584e49e6Nf76f2ce8.jpg"}]},"inOrderCount30Days":17,"inOrderCount30DaysSku":9,"isHot":1,"materialUrl":"item.jd.com/10122987694.html","owner":"p","pinGouInfo":[],"priceInfo":{"price":1980},"resourceInfo":{"eliteId":1,"eliteName":"好券商品"},"shopInfo":{"shopId":116427,"shopName":"左薇莎旗舰店"},"skuId":10122987694,"skuName":"左薇莎(Jowissa) 瑞士原装进口手表 男士腕表 计时闹铃多功能石英表 夜光超薄防水 时尚休闲 黑色-表盘40MM-J7.006.L","spuid":10122987692}],"totalCount":197},"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对