API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)
千人千面个性化推荐接口

京东千人千面个性化推荐的商品信息接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

个性化推荐物料商品查询接口:通过输入频道id、userid即可获取个性化推荐的商品信息,目前联盟推荐的精选频道包含“猜你喜欢、实时热销、大额券、9.9包邮”等各种实时数据,适用于to C搭建频道页,千人千面商品推荐模块场景。

建议使用clickURL转链长链接,千人千面推荐效果会更好。

注意:请勿传入排序参数,以免影响推荐效果。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/jd/jd_materialquery 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
eliteId Number 1 频道ID:1.猜你喜欢、2.实时热销、3.大额券、4.9.9包邮、1001.选品库
pageIndex Number 1 页码
pageSize Number 10 每页数量,最大10
sortName String price 该字段无效,请勿传入
sort String asc 该字段无效,请勿传入
pid String 联盟id_应用id_推广位id,三段式,联盟子推客身份标识(不能传入接口调用者自己的pid)
subUnionId String 618_18_c35***e6a 子渠道标识,(需申请),该字段为自定义参数,仅支持传入字母、数字、下划线或中划线,最多80个字符(不可包含空格)
siteId String 435676 站点ID是指在联盟后台的推广管理中的网站Id、APPID(1、通用转链接口禁止使用社交媒体id入参;2、订单来源,即投放链接的网址或应用必须与传入的网站ID/AppID备案一致,否则订单会判“无效-来源与备案网址不符”)
positionId String 1 推广位id
ext1 String 100_618_618 系统扩展参数,无需传入
skuId Number 1111 预留字段,请勿传入
hasCoupon Number 1 1:只查询有最优券商品,不传值不做限制
userIdType Number 32 用户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); 131072(安卓移动设备oaid的md5编码,32位,大写)
userId String 示例1: userIdType设置为8时,此时userId需要设置为安卓移动设备Imei,如861794042953717 示例2: userIdType设置为16时,此时userId需要设置为苹果移动设备Openudid,如f99dbd2ba8de45a65cd7f08b7737bc919d6c87f7 示例3: userIdType设置为32时,此时userId需要设置为苹果移动设备idfa,如DCC77BDA-C2CA-4729-87D6-B7F65C8014D6 示例4: userIdType设置为64时,此时userId需要设置为安卓移动设备imei的32位大写的MD5编码,如1097787632DB8876D325C356285648D0(原始imei:861794042953717) 示例5: userIdType设置为128时,此时userId需要设置为苹果移动设备idfa的32位大写的MD5编码,如38D7C90186B1328F9418816DCC762A27(原始idfa:DCC77BDA-C2CA-4729-87D6-B7F65C8014D6) 示例6: userIdType设置为32768时,此时userId需要设置为安卓移动设备oaid,如7dafe7ff-bffe-a28b-fdf5-7fefdf7f7e85 示例7: userIdType设置为131072时,此时userId需要设置为安卓移动设备oaid的32位大写的MD5编码,如4967357D630E32E312A3A3EE0C5A128B(原始oaid:7dafe7ff-bffe-a28b-fdf5-7fefdf7f7e85) userIdType对应的用户设备ID,传入此参数可获得个性化推荐结果,userIdType和userId需同时传入
fields String videoInfo 支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息),hotWords(热词),similar(相似推荐商品),documentInfo(段子信息),skuLabelInfo(商品标签),promotionLabelInfo(商品促销标签)
forbidTypes String 10,11 10微信京东购物小程序禁售,11微信京喜小程序禁售
orderId String 108618000005 该字段无效,请勿传入
groupId Number 1 选品库id(仅对eliteId=1001有效,且必传)
ownerUnionId Number 5227 groupId创建者的UnionId
benefitType Number 1 类型 0:选品库
channelId Number 100001 渠道关系ID
ip String 111.202.149.15 客户端ip
provinceId Number 1 省Id
cityId Number 2802 市Id
countryId Number 54745 县Id
townId Number 2032 镇Id

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
  1. GET/POST  http://api.veapi.cn/jd/jd_materialquery?vekey=xxx&eliteId=1&hasCoupon=1
使用curl函数,curl不是php原生库,需要安装才能使用

  1. $api="http://api.veapi.cn/jd/jd_materialquery?vekey=xxx&eliteId=1&hasCoupon=1";
  2.  
  3. $ch = curl_init();
  4. curl_setopt($ch, CURLOPT_URL, $api);
  5. //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用
  6. //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参
  7.  
  8. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用
  9. curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用
  10. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出
  11. curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
  12. curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S
  13. curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
  14.  
  15. $result = curl_exec($ch);
  16. $info = curl_getinfo($ch);
  17. curl_close($ch);
  18.  
  19. echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

  1. import cn.hutool.http.HttpResponse;
  2. import cn.hutool.http.HttpRequest;
  3.  
  4. public class testGetParam {
  5.  
  6. public static void main(String[] args) {
  7. // API网址
  8. String url = "http://api.veapi.cn/jd/jd_materialquery?vekey=xxx&eliteId=1&hasCoupon=1";
  9. // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
  10. //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");
  11.  
  12. // 发送请求
  13. String result = HttpRequest.get(url)
  14. .timeout(10000)//设置超时,毫秒
  15. .execute().body();
  16. System.out.println(result);
  17. }
  18. }
推荐使用 requests,支持访问http,https网页:

  1. import requests
  2.         
  3. # 要访问的API网页
  4. target_url = "http://api.veapi.cn/jd/jd_materialquery?vekey=xxx&eliteId=1&hasCoupon=1"
  5.  
  6. # 发送请求
  7. response = requests.get(target_url)
  8.  
  9. # 获取页面内容
  10. if response.status_code == 200:
  11.     print response.text

返回值(JSON)

参数名称 参数类型 是否必选 示例值 描述
categoryInfo Map 类目信息
 └─ cid1 Number 6144 一级类目ID
 └─ cid1Name String 珠宝首饰 一级类目名称
 └─ cid2 Number 12041 二级类目ID
 └─ cid2Name String 木手串/把件 二级类目名称
 └─ cid3 Number 12052 三级类目ID
 └─ cid3Name String 其他 三级类目名称
comments Number 999 评论数
commissionInfo Map   佣金信息
 └─ commission Number 22.68 佣金
 └─ commissionShare Number 50 佣金比例
 └─ couponCommission Number 12.68 券后佣金,(促销价-优惠券面额)*佣金比例
 └─ plusCommissionShare Number 50 plus佣金比例,plus用户购买推广者能获取到的佣金比例
couponInfo Map 优惠券信息,返回内容为空说明该SKU无可用优惠券
 └─ bindType Number 3 券种类 (优惠券种类:0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券)
 └─ discount Number 30 券面额
 └─ link String http://coupon.jd.com/ilink/couponActiveFront/front_index.action?XXXXXXX 券链接
 └─ platformType Number 0 券使用平台 (平台类型:0 - 全平台券,1 - 限平台券)
 └─ quota Number 39 券消费限额
 └─ getStartTime Number 1532921782000 领取开始时间(时间戳,毫秒)
 └─ getEndTime Number 1532921782000 券领取结束时间(时间戳,毫秒)
 └─ useStartTime Number 1532921782000 券有效使用开始时间(时间戳,毫秒)
 └─ useEndTime Number 1532921782000 券有效使用结束时间(时间戳,毫秒)
 └─ isBest Number 1 最优优惠券,1:是;0:否,购买一件商品可使用的面额最大优惠券
goodCommentsShare Number 99 商品好评率
imageInfo Map 图片信息
 └─ url String http://img14.360buyimg.com/ads/jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg 图片链接地址,第一个图片链接为主图链接
whiteImage String https://img14.360buyimg.com/pop/jfs/t1/74611/40/9199/226994/5d6f1c60E211d7a9e/e69c31469897a95a.png 白底图
inOrderCount30Days Number 6018 30天引单数量
priceInfo Priceinfo 价格信息
 └─ price Number 39.9 商品价格
 └─ lowestPrice Number 14.9 促销价
 └─ lowestPriceType Number 2 促销价类型,1:商品价格;2:拼购价格; 3:秒杀价格; 4:预售价格
 └─ lowestCouponPrice Number 10.9 券后价(有无券都返回此字段)
shopInfo Shopinfo 店铺信息
 └─ shopName String XXXX旗舰店 店铺名称(或供应商名称)
 └─ shopId Number 45619 店铺Id
 └─ shopLevel Number 3.5 店铺评分
 └─ shopLabel String 1 1:京东好店 https://img12.360buyimg.com/schoolbt/jfs/t1/80828/19/2993/908/5d14277aEbb134d76/889d5265315e11ed.png
 └─ userEvaluateScore String 9.46 用户评价评分(仅pop店铺有值)
 └─ commentFactorScoreRankGrade String 用户评价评级(仅pop店铺有值)
 └─ logisticsLvyueScore String 9.69 物流履约评分(仅pop店铺有值)
 └─ logisticsFactorScoreRankGrade String 物流履约评级(仅pop店铺有值)
 └─ afterServiceScore String 8.98 售后服务评分(仅pop店铺有值)
 └─ afsFactorScoreRankGrade String 售后服务评级(仅pop店铺有值)
 └─ scoreRankRate String 94.36 店铺风向标(仅pop店铺有值)
skuId Number 26898778009 商品ID
skuName String 便携式女士香水持久淡香小样 初见系列香水 遇见时光 商品名称
isHot Number 1 已废弃,请勿使用
spuid Number 3491692 同款商品的主skuid
brandCode String 悍途(Humtto) 品牌名
owner String g g=自营,p=pop
pinGouInfo Map 拼购信息
 └─ pingouPrice Number 39.9 拼购价格
 └─ pingouTmCount Number 2 拼购成团所需人数
 └─ pingouStartTime Number 2133999048000 拼购开始时间(时间戳,毫秒)
 └─ pingouEndTime Number 2133999048000 拼购结束时间(时间戳,毫秒)
resourceInfo Map 资源信息
 └─ eliteId Number 11 频道id
 └─ eliteName String 品牌好货-潮流范儿 频道名称
inOrderCount30DaysSku Number 100 30天引单数量(sku维度)
seckillInfo Map 秒杀信息
 └─ seckillOriPrice Number 36.9 秒杀价原价
 └─ seckillPrice Number 26.8 秒杀价
 └─ seckillStartTime Number 1574474399000 秒杀开始时间(时间戳,毫秒)
 └─ seckillEndTime Number 1574474399000 秒杀结束时间(时间戳,毫秒)
jxFlags Number[] [1,2,3] 京喜商品类型,1京喜、2京喜工厂直供、3京喜优选
videoInfo Map 视频信息
 └─ width Number 400
 └─ high Number 300
 └─ imageUrl String https://img.300hu.com/4c1f7a6atransbjngwcloud1oss/44128edd173016898433773569/imageSampleSnapshot/1555986468_406717890.100_2756.jpg 视频图片地址
 └─ videoType Number 1 1:主图,2:商详
 └─ playType String high low:标清,high:高清
 └─ duration Number 10 时长(单位:s)
 └─ playUrl String https://vod.https://vod.300hu.com/... 播放地址
promotionInfo Map 推广信息
 └─ clickURL String https://union-xxx 长链推广(转链长链接,无需调用转链接口)
bookInfo Map 图书信息
 └─ isbn String 9787515515564 图书编号
forbidTypes Number[] [0,10,11] 0普通商品,10微信京东购物小程序禁售,11微信京喜小程序禁售
deliveryType Number 1 京东配送 1:是,0:不是
skuLabelInfo Map   商品标签
 └─ is7ToReturn Number 1 0:不支持; 1或null:支持7天无理由退货; 2:支持90天无理由退货; 4:支持15天无理由退货; 6:支持30天无理由退货;
fxg Number 1 1:放心购商品
fxgServiceList Map   放心购商品子标签集合,此字段值可能为空
 └─ serviceName String 破损包退换 服务名称
promotionLabelInfoList Map   商品促销标签集
 └─ promotionLabel String 满2件,总价打8折 商品促销文案
 └─ lableName String 满折 促销标签名称
 └─ startTime Number 1608998400000 促销开始时间
 └─ endTime Number 1608998400000 促销结束时间
 └─ promotionLableId Number 5000125161 促销ID
materialUrl String https://item.jd.com/11144230.html 落地页
preSaleInfo Map   预售信息
 └─ currentPrice Number 100 预售价格
 └─ earnest Number 15 订金金额(定金不能超过预售总价的20%)
 └─ preSalePayType Number 1 预售支付类型:1.仅全款 2.定金、全款均可 5.一阶梯仅定金
 └─ discountType Number 1 1: 定金膨胀 2: 定金立减
 └─ depositWorth Number 10 定金膨胀金额(定金可抵XXX)【废弃】
 └─ preAmountDeposit Number 10 立减金额
 └─ preSaleStartTime Number 1546444800000 定金开始时间
 └─ preSaleEndTime Number 1546444800000 定金结束时间
 └─ balanceStartTime Number 1546444800000 尾款开始时间
 └─ balanceEndTime Number 1546444800000 尾款结束时间
 └─ shipTime Number 1546444800000 预计发货时间
 └─ preSaleStatus Number 1 预售状态(0 未开始;1 预售中;2 预售结束;3 尾款进行中;4 尾款结束)
 └─ amountDeposit Number 10 定金膨胀金额(定金可抵XXX)
reserveInfo Map   预约信息
 └─ price Number 15 预约价格
 └─ type Number 1 预约类型: 1:预约购买资格(仅预约的用户才可以进行购买); 5:预约抽签(仅中签用户可购买)
 └─ status Number 1 1:等待预约 2:预约中 3:等待抢购/抽签中 4:抢购中 5:抢购结束
 └─ startTime Number 1601364491000 预定开始时间
 └─ endTime Number 1601364491000 预定结束时间
 └─ panicBuyingStartTime Number 1601364491000 抢购开始时间
 └─ panicBuyingEndTime Number 1601364491000 抢购结束时间
addCartPrice Number 100 预留字段
secondPriceInfoList Map 双价格信息
 └─ secondPriceType Number 2 双价格类型:18新人价,2plus会员价格
 └─ secondPrice Number 8.8 价格
isOversea Number 1 是否全球购商品 1:是
companyType Number 2 2:POP自然人小店
purchasePriceInfo Purchasepriceinfo   到手价明细
 └─ purchasePrice Number 30.9 到手价
 └─ thresholdPrice Number 39.9 门槛价金额,计算到手价的基准价
 └─ basisPriceType Number 1 依据的价格类型,1、京东价 ,2 Plus价,7 粉丝价,8 新人价,9学生价,10 陪伴计划价(双价格新增)
promotionLabelInfo Promotionlabelinfo   商品促销标签
 └─ promotionLabel String 满2件,总价打8折 商品促销文案
 └─ startTime Number 1608998400000 促销开始时间
 └─ endTime Number 1609862399000 促销结束时间
 └─ promotionLabelId Number 5000125161 促销ID
 └─ labelName String 满折 促销标签名称
couponList Coupon[]   优惠券集合
 └─ bindType Number 3 券种类 (优惠券种类:0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券)
 └─ discount Number 30 券面额
 └─ link String http://coupon.jd.com/... 券链接
 └─ platformType Number 0 券使用平台 (平台类型:0 - 全平台券,1 - 限平台券)
 └─ quota Number 39 券消费限额
 └─ couponStyle Number 0 优惠券分类 0:满减券,3:满折券
activityCardInfo Activitycardinfo   超市购物卡明细
 └─ amount Number 100 超市卡金额
 └─ activityType Number 3 活动类型,购物返卡:3
 └─ expireDay Number 5 超市卡有效天数
kaAdowner Number 1 是否星选商家商品。1:是
itemId String Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF 联盟商品ID
totalCount Number 100 有效商品总数量

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{}

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部