淘宝联盟API
京东联盟API
拼多多API
唯品会API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
点击获取APKEY

正常 京东商品查询API 接口测试

京东联盟推广商品查询接口,支持推广链接查询、关键词查询、优惠券商品查询、拼购商品查询、爆款商品查询

接口地址: http://api.web.ecapi.cn/jingdong/getJdUnionItems
接口实例: http://api.web.ecapi.cn/jingdong/getJdUnionItems?apkey=登录会员中心查看
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 全部会员 (新用户注册立刻送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拼购价格区间结束
hasContentString11:查询内容商品;其他值过滤掉此入参条件。
brandCodeString7998品牌code
shopIdString45619店铺Id
hasBestCouponString11:查询有最优惠券商品;其他值过滤掉此入参条件。
pidString618_618_618联盟id_应用iD_推广位id
fieldsStringvideoInfo支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息),hotWords(热词),similar(相似推荐商品),documentInfo(段子信息)
forbidTypesString2,3,5微信京东购物小程序禁售商品过滤规则,入参表示不展示该规则数据,支持多个逗号','分隔,2:OTC商品;3:加油卡;4:游戏充值卡;5:合约机;6:京保养;7:虚拟组套;8:定制商品
jxFlagsString1,2京喜商品类型,1京喜、2京喜工厂直供、3京喜优选(包含3时可在京东APP购买),入参多个值表示或条件查询,多个值需用,分割
shopLevelFromString3.5支持传入0.0、2.5、3.0、3.5、4.0、4.5、4.9,默认为空表示不筛选评分

返回参数

返回参数类型参数说明扩展说明
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请求方式不对