淘宝联盟API

京东联盟API

数据接口API

点击获取APKEY

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

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

接口地址： http://api.web.ecapi.cn/jingdong/getJdUnionItems

接口实例： http://api.web.ecapi.cn/jingdong/getJdUnionItems?apkey=登录会员中心查看&key_id=JXXXXX

注意事项：如调用接口时数据返回异常，则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码，然后再试。

请求方式：GET

会员范围：全部会员 (新用户注册立刻送7天V1付费会员【注：赠送会员可使用全部接口，但调用频率与免费会员一致，免费会员调用频率可参考会员等级说明】)

必看注意：为保障接口安全及使用效率，调用本站接口前需先添加IP白名单 (IP地址测试)，若IP不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<- 。

使用说明: 变更说明：
原接口返回数据中的lists字段调整为list，去掉了s，其他不变

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
skuIds	String	000000,11111		skuIds集合，最大支持100个商品，可为空。如果传值，忽略其他查询条件。（原数字ID使用，新版ID在keyword中传入）
cid1	String	xxxx		一级类目id
cid2	String	xxxx		二级类目id
cid3	String	xxxx		三级类目id
keyword	String	xxxx		新版商品ID；商品关键词，字数同京东商品名称一致，目前未限制，可传入联盟推广链接查询指定商品
pageIndex	String	1		页码
pageSize	String	20		每页数量，单页数最大30，默认20
pricefrom	String	16.88		商品价格下限
priceto	String	19.88		商品价格上限
commissionShareStart	String	10		佣金比例区间开始
commissionShareEnd	String	50		佣金比例区间结束
pageSize	String	Number		每页数量，单页数最大30，默认20
owner	String	g		商品类型：自营[g]，POP[p]
sortName	String	price		排序字段(price：单价, commissionShare：佣金比例, commission：佣金， inOrderCount30Days：30天引单量， inOrderComm30Days：30天支出佣金)
sort	String	desc		asc,desc升降序,默认降序
isCoupon	String	1		是否是优惠券商品，1：有优惠券，0：无优惠券
isPG	String	0		是否是拼购商品，1：拼购商品，0：非拼购商品
pingouPriceStart	String	16.88		拼购价格区间开始
pingouPriceEnd	String	19.88		拼购价格区间结束
hasContent	String	1		1：查询内容商品；其他值过滤掉此入参条件。
brandCode	String	7998		品牌code
shopId	String	45619		店铺Id
hasBestCoupon	String	1		1：查询有最优惠券商品；其他值过滤掉此入参条件。
pid	String	618_618_618		联盟id_应用iD_推广位id
fields	String	videoInfo		支持出参数据筛选，逗号','分隔，目前可用：videoInfo(视频信息),hotWords(热词),similar(相似推荐商品),documentInfo(段子信息)
forbidTypes	String	2,3,5		微信京东购物小程序禁售商品过滤规则，入参表示不展示该规则数据，支持多个逗号','分隔，2:OTC商品;3:加油卡;4:游戏充值卡;5:合约机;6:京保养;7:虚拟组套;8:定制商品
jxFlags	String	1,2		京喜商品类型，1京喜、2京喜工厂直供、3京喜优选（包含3时可在京东APP购买），入参多个值表示或条件查询，多个值需用,分割
shopLevelFrom	String	3.5		支持传入0.0、2.5、3.0、3.5、4.0、4.5、4.9，默认为空表示不筛选评分
sceneId	String	1		新增sceneId字段（场景ID），支持入参1，2。1、skuIds字段：仅支持sceneId=2时入参。 2、keyword字段：sceneId=2时支持入参京东主站商品ID、京东商品链接（包含3.cn单品链接）。其他场景仅支持入参关键词、联盟商品ID、联盟商品链接
key_id	String	JXXXXX	是	登录授权的key_id，文档见：https://doc.21ds.cn/detail?doc=4685763267728060/5035713861583853

返回参数

返回参数	类型	参数说明	扩展说明
totalCount	Number	请求到的总商品数
list	Json	商品列表
├　categoryInfo	Json	类目信息
├　　├　cid1	String	一级类目ID	–
├　　├　cid1Name	String	一级类目名	–
├　　├　cid2	String	二级类目ID	–
├　　├　cid2Name	String	二级类目名	–
├　　├　cid3	String	三级类目ID	–
├　　├　cid3Name	String	三级类目名	–
├　commissionInfo	Json	佣金信息
├　　├　commission	String	佣金	–
├　　├　commissionShare	String	佣金比例	百分比，如显示25，则佣金比例为25%
├　　├　couponCommission	String	券后佣金	可能没有
├　　├　plusCommissionShare	String	plus佣金比例	可能没有
├　couponInfo	Json	优惠券信息，返回内容为空说明该SKU无可用优惠券
├　　├　couponList	String	优惠券合集
├　　├　　├　bindType	String	券种类	优惠券种类：0 - 全品类，1 - 限品类（自营商品），2 - 限店铺，3 - 店铺限商品券
├　　├　　├　discount	String	券面额	–
├　　├　　├　link	String	券链接	http://coupon.jd.com/ilink/couponActiveFront/front_index.action?XXXXXXX
├　　├　　├　platformType	String	券使用平台	平台类型：0 - 全平台券，1 - 限平台券
├　　├　　├　quota	String	券消费限额	–
├　　├　　├　getStartTime	String	领取开始时间	时间戳，毫秒值
├　　├　　├　getEndTime	String	券领取结束时间	时间戳，毫秒值
├　　├　　├　useStartTime	String	券有效使用开始时间	时间戳，毫秒值
├　　├　　├　useEndTime	String	券有效使用结束时间	时间戳，毫秒值
├　　├　　├　isBest	String	是否是最优优惠券	1=最优优惠券，0=其他
├　imageInfo	Json	图片信息
├　　├　imageList	Json	图片合集
├　　├　　├　url	String	图片链接地址
├　priceInfo	Json	价格信息
├　　├　price	String	无线价格
├　shopInfo	String	店铺信息
├　　├　shopName	String	店铺名称（或供应商名称）
├　　├　shopId	String	店铺ID
├　comments	String	评论数	–
├　goodCommentsShare	String	商品好评率	–
├　inOrderCount30Days	String	30天引单数量	–
├　isJdSale	String	是否自营 (1 : 是, 0 : 否)，后续会废弃，请用owner	–
├　materialUrl	String	商品落地页	–
├　skuId	String	商品ID	–
├　skuName	String	商品名称	–
├　isHot	String	是否爆款	1：是，0：否
├　spuid	String	spuid，其值为同款商品的主skuid	–
├　brandCode	String	品牌code	–
├　brandName	String	品牌名	–
├　owner	String	g=自营，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	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对

【公告】

数据接口API

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

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851

数据接口API

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

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851

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