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

正常 猜你喜欢商品推荐

更新时间:2020-11-30 17:24:25

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

使用说明

输入频道id、userId、userIdType即可获取个性化推荐的商品信息,目前联盟推荐的精选频道包含猜你喜欢、实时热销、大额券、9.9包邮等各种实时数据,适用于toc搭建频道页,千人千面商品推荐模块场景。

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
eliteIdString1频道ID:1.猜你喜欢、2.实时热销、3.大额券、4.9.9包邮
pageIndexString1页码
pageSizeString10每页数量,最大10
sortNameStringinOrderCount30DaysSku排序字段(lowestPrice:最低价, inOrderCount30DaysSku:sku维度30天引单量,comments:评论数,goodComments:好评数)
sortStringdescasc,desc升降序,默认降序
pidString联盟id_应用id_推广位id,三段式
subUnionIdStringxxxx子联盟ID(需向我们申请),该字段为自定义参数,建议传入字母数字和下划线的格式
siteIdString站点ID是指在联盟后台的推广管理中的网站Id、APPID(1、通用转链接口禁止使用社交媒体id入参;2、订单来源,即投放链接的网址或应用必须与传入的网站ID/AppID备案一致,否则订单会判“无效-来源与备案网址不符”)
positionIdStringxxxx推广位id
hasCouponString11:只查询有最优券商品,不传值不做限制
userIdTypeString32用户ID类型,传入此参数可获得个性化推荐结果。当前userIdType支持的枚举值包括:8、16、32、64、128、32768。userIdType和userId需同时传入,且一一对应。userIdType各枚举值对应的userId含义如下:8(安卓移动设备Imei); 16(苹果移动设备Openudid);32(苹果移动设备idfa); 64(安卓移动设备imei的md5编码,32位,大写,匹配率略低);128(苹果移动设备idfa的md5编码,32位,大写,匹配率略低); 32768(安卓移动设备oaid)
userIdStringxxxxuserIdType对应的用户设备ID,传入此参数可获得个性化推荐结果,userIdType和userId需同时传入
fieldsStringvideoInfo支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息)

返回参数

返回参数类型参数说明扩展说明
listJson返回数据列表
 ├ categoryInfoJson类目信息
 ├  ├ cid1String一级类目ID
 ├  ├ cid1NameString一级类目名称
 ├  ├ cid2String二级类目ID
 ├  ├ cid2NameString二级类目名称
 ├  ├ cid3String三级类目ID
 ├  ├ cid3NameString三级类目名称
 ├ commentsString评论数
 ├ commissionInfoJson佣金信息
 ├  ├ commissionString佣金
 ├  ├ commissionShareString佣金比例
 ├  ├ couponCommissionString券后佣金
 ├  ├ plusCommissionShareStringplus佣金比例
 ├ couponInfoJson优惠券信息,返回内容为空说明该SKU无可用优惠券
 ├  ├ couponListJson优惠券合集
 ├  ├  ├ bindTypeString券种类0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券
 ├  ├  ├ discountString券面额
 ├  ├  ├ linkString券链接
 ├  ├  ├ platformTypeString券使用平台0 - 全平台券,1 - 限平台券
 ├  ├  ├ quotaString券消费限额
 ├  ├  ├ getStartTimeString领取开始时间时间戳,毫秒
 ├  ├  ├ getEndTimeNumber券领取结束时间时间戳,毫秒
 ├  ├  ├ useStartTimeNumber券有效使用开始时间时间戳,毫秒
 ├  ├  ├ useEndTimeString券有效使用结束时间时间戳,毫秒
 ├  ├  ├ isBestNumber最优优惠券1:是;0:否
 ├ goodCommentsShareString商品好评率
 ├ imageInfoJson图片信息
 ├  ├ imageListJson图片合集
 ├ inOrderCount30DaysNumber30天引单数量
 ├ priceInfoJson价格信息
 ├  ├ priceString无线价格
 ├  ├ lowestPriceString最低价格
 ├  ├ lowestPriceTypeString最低价格类型1:无线价格;2:拼购价格; 3:秒杀价格
 ├  ├ lowestCouponPriceString最低价后的优惠券价
 ├ shopInfoJson店铺信息
 ├  ├ shopNameString店铺名称(或供应商名称)
 ├  ├ shopIdNumber店铺Id
 ├  ├ shopLevelString店铺评分
 ├ skuIdNumber商品ID
 ├ skuNameString商品名称
 ├ isHotNumber是否爆款1:是,0:否
 ├ spuidStringspuid,其值为同款商品的主skuid
 ├ brandCodeString品牌名
 ├ ownerStringg=自营,p=pop
 ├ pinGouInfoJson拼购信息
 ├  ├ pingouPriceNumber拼购价格
 ├  ├ pingouTmCountNumber拼购成团所需人数
 ├  ├ pingouStartTimeNumber拼购开始时间时间戳,毫秒
 ├  ├ pingouEndTimeNumber拼购结束时间时间戳,毫秒
 ├ resourceInfoJson资源信息
 ├  ├ eliteIdNumber频道id
 ├  ├ eliteNameString频道名称
 ├ inOrderCount30DaysSkuNumber30天引单数量(sku维度)
 ├ seckillInfoJson秒杀信息
 ├  ├ seckillOriPriceNumber秒杀价原价
 ├  ├ seckillPriceNumber秒杀价
 ├  ├ seckillStartTimeNumber秒杀开始时间时间戳,毫秒
 ├  ├ seckillEndTimeNumber秒杀结束时间时间戳,毫秒
 ├ jxFlagsString京喜商品类型1京喜、2京喜工厂直供、3京喜优选
 ├ videoInfoJson视频信息
 ├  ├ videoListJson视频集合
 ├  ├  ├ widthNumber
 ├  ├  ├ highNumber
 ├  ├  ├ imageUrlString视频图片地址
 ├  ├  ├ videoTypeNumber1:主图,2:商详
 ├  ├  ├ playTypeStringlow:标清,high:高清
 ├  ├  ├ durationNumber时长(单位:s)
 ├  ├  ├ playUrlString播放地址
 ├ promotionInfoJson推广信息
 ├  ├ clickURLString长链推广重新调用转链接口转,不要使用这个
totalCountNumber有效商品总数量

Json返回示例

{"code":200,"data":{"list":[{"brandCode":"22186","brandName":"统帅(Leader)","categoryInfo":{"cid1":737,"cid1Name":"家用电器","cid2":794,"cid2Name":"大 家 电","cid3":880,"cid3Name":"洗衣机"},"comments":2689,"commissionInfo":{"commission":254.85,"commissionShare":15,"couponCommission":253.35,"plusCommissionShare":15},"couponInfo":{"couponList":[{"bindType":3,"discount":10,"getEndTime":1598889599000,"getStartTime":1594656000000,"isBest":1,"link":"https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoeQ5Sz5SBdcPodaCNc8951GVEWf1nphGjAbhFIBHERKIBXtd5AKO5B5_ckt5_SpQ4cM5imZw","platformType":0,"quota":500,"useEndTime":1598975999000,"useStartTime":1594656000000}]},"goodCommentsShare":99,"imageInfo":{"imageList":[{"url":"http://img14.360buyimg.com/pop/jfs/t1/147802/36/3905/155429/5f1e8447E01baa607/8af9c39840ffd0ee.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/91353/23/3396/81590/5ddf7b27E2517c8ca/95b73fea25529716.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/53510/23/16962/116938/5ddf7b26E605bfb53/28b075ce0a8d649d.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/105674/5/3329/316099/5ddf7b27E47c64185/11ea06070f2e167f.png"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/94322/28/3310/106285/5ddf7b26Ee9ef382b/24dc56fb91e7eacc.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/74293/7/16549/86047/5ddf7b27Edc58085b/f3c80ec5ed32a9db.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/64669/34/16449/61129/5ddf7b26Ee8002f99/f82f3e6b096a7707.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/70157/4/16262/101387/5ddf7b26E9dd51842/3b6dafbea3ccf8d4.jpg"},{"url":"http://img14.360buyimg.com/pop/jfs/t1/97719/10/3175/61017/5ddf7b26E8f3370f3/bbf981d3645c38f0.jpg"}]},"inOrderCount30Days":23,"inOrderCount30DaysSku":22,"isHot":1,"owner":"p","pinGouInfo":[],"priceInfo":{"lowestCouponPrice":1689,"lowestPrice":1699,"lowestPriceType":1,"price":1699},"promotionInfo":{"clickURL":"https://union-click.jd.com/jdc?e=&p=AyIGZRprEAEXDlAfXxIHFgJlXwRNXE03DF4eVEAZGUtDHkFeDVtKQA4KUExbS1oYS1dWVRAFXhYHGwJRH1wQBhcYDF4HSDISVREcDAtCcGQXT1JeW1YHAH5TdH5EC1krWiUHEQBSGmslAhI3HnVaJQMiB1ETXBMDEARVEl0dBiIEVBlrFQQXB1IfXhcCDg5RE1kTByI3ZRhrJTISN1YrGHsCfFk7GggWUUAABhI1T1dKXBJJARRsFQNRH1sQAhA3VxpaFQs="},"resourceInfo":{"eliteId":1,"eliteName":"猜你喜欢"},"shopInfo":{"shopId":756932,"shopLevel":4.5,"shopName":"海尔冰洗百诚专卖店"},"skuId":42484556454,"skuName":"海尔滚筒洗衣机 9/10公斤大容量智能变频家用全自动洗衣机 蒸汽除螨洗 中途添衣统帅 【升级版】金色10公斤变频洗衣机双层视窗","spuid":25527551693,"videoInfo":[]}],"totalCount":476},"msg":"success"}

code/http_status说明

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