点击获取APKEY

正常 (重构版)京东商品查询API


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

使用说明

变更说明:

原接口返回数据中的lists字段调整为list,去掉了s,其他不变

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
skuIdsString000000,11111skuIds集合,最大支持100个商品,可为空。如果传值,忽略其他查询条件。
cid1Stringxxxx一级类目id
cid2Stringxxxx二级类目id
cid3Stringxxxx三级类目id
keywordStringxxxx商品关键词,字数同京东商品名称一致,目前未限制
pageIndexString1页码
pageSizeString20每页数量,单页数最大30,默认20
pricefromString16.88商品价格下限
pricetoString19.88商品价格上限
commissionShareStartString10佣金比例区间开始
commissionShareEndString50佣金比例区间结束
pageSizeStringNumber每页数量,单页数最大30,默认20
ownerStringg商品类型:自营[g],POP[p]
sortNameStringprice排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30Days:30天引单量, inOrderComm30Days:30天支出佣金)
sortStringdescasc,desc升降序,默认降序
isCouponString1是否是优惠券商品,1:有优惠券,0:无优惠券
isPGString0是否是拼购商品,1:拼购商品,0:非拼购商品
pingouPriceStartString16.88拼购价格区间开始
pingouPriceEndString19.88拼购价格区间结束
isHotString1是否是爆款,1:爆款商品,0:非爆款商品
brandCodeString7998品牌code
shopIdString45619店铺Id

返回参数

返回参数类型参数说明扩展说明
totalCountNumber请求到的总商品数
listJson商品列表
 ├ categoryInfoJson类目信息
 ├  ├ cid1String一级类目ID
 ├  ├ cid1NameString一级类目名
 ├  ├ cid2String二级类目ID
 ├  ├ cid2NameString二级类目名
 ├  ├ cid3String三级类目ID
 ├  ├ cid3NameString三级类目名
 ├ commissionInfoJson佣金信息
 ├  ├ commissionString佣金
 ├  ├ commissionShareString佣金比例百分比,如显示25,则佣金比例为25%
 ├  ├ couponCommissionString券后佣金可能没有
 ├  ├ plusCommissionShareStringplus佣金比例可能没有
 ├ couponInfoJson优惠券信息,返回内容为空说明该SKU无可用优惠券
 ├  ├ couponListString优惠券合集
 ├  ├  ├ bindTypeString券种类优惠券种类:0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券
 ├  ├  ├ discountString券面额
 ├  ├  ├ linkString券链接http://coupon.jd.com/ilink/couponActiveFront/front_index.action?XXXXXXX
 ├  ├  ├ platformTypeString券使用平台平台类型:0 - 全平台券,1 - 限平台券
 ├  ├  ├ quotaString券消费限额
 ├  ├  ├ getStartTimeString领取开始时间时间戳,毫秒值
 ├  ├  ├ getEndTimeString券领取结束时间时间戳,毫秒值
 ├  ├  ├ useStartTimeString券有效使用开始时间时间戳,毫秒值
 ├  ├  ├ useEndTimeString券有效使用结束时间时间戳,毫秒值
 ├  ├  ├ isBestString是否是最优优惠券1=最优优惠券,0=其他
 ├ imageInfoJson图片信息
 ├  ├ imageListJson图片合集
 ├  ├  ├ urlString图片链接地址
 ├ priceInfoJson价格信息
 ├  ├ priceString无线价格
 ├ shopInfoString店铺信息
 ├  ├ shopNameString店铺名称(或供应商名称)
 ├  ├ shopIdString店铺ID
 ├ commentsString评论数
 ├ goodCommentsShareString商品好评率
 ├ inOrderCount30DaysString30天引单数量
 ├ isJdSaleString是否自营 (1 : 是, 0 : 否),后续会废弃,请用owner
 ├ materialUrlString商品落地页
 ├ skuIdString商品ID
 ├ skuNameString商品名称
 ├ isHotString是否爆款1:是,0:否
 ├ spuidStringspuid,其值为同款商品的主skuid
 ├ brandCodeString品牌code
 ├ brandNameString品牌名
 ├ ownerStringg=自营,p=pop

Json返回示例

{"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说明

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