京粉/京喜/京东精选商品查询接口
23103人使用

京东联盟精选优质商品,每日更新,可通过频道ID查询各个频道下的精选商品。用获取的优惠券链接调用转链接口时,需传入搜索接口link字段返回的原始优惠券链接,切勿对链接进行任何encode、decode操作,否则将导致转链二合一推广链接时校验失败。

查看详细说明
接口地址: http://api.tbk.dingdanxia.com/jd/query_jingfen_goods 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

eliteId

int

1

频道ID:1-好券商品,2-精选卖场,10-9.9包邮,15-京东配送,22-实时热销榜,23-为你推荐,24-数码家电,25-超市,26-母婴玩具,27-家具日用,28-美妆穿搭,30-图书文具,31-今日必推,32-京东好物,33-京东秒杀,34-拼购商品,40-高收益榜,41-自营热卖榜,108-秒杀进行中,109-新品首发,110-自营,112-京东爆品,125-首购商品,129-高佣榜单,130-视频商品,153-历史最低价商品榜,210-极速版商品,238-新人价商品,247-京喜9.9,249-京喜秒杀

pageIndex

int

1

页码

pageSize

int

20

每页数量,默认20,上限50

sortName

String

price

排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30DaysSku:sku维度30天引单量,comments:评论数,goodComments:好评数)

sort

String

desc

asc,desc升降序,默认降序

pid

String

618_618_618

联盟id_应用id_推广位id,三段式

fields

String

videoInfo

支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息),hotWords(热词),similar(相似推荐商品),documentInfo(段子信息),skuLabelInfo(商品标签),promotionLabelInfo(商品促销标签)

forbidTypes

String

10,11

10微信京东购物小程序禁售,11微信京喜小程序禁售

返回参数说明

标记

类型

例子

说明

categoryInfo

json

类目信息

L cid1

long

6114

一级类目ID

L cid1Name

String

珠宝首饰

一级类目名称

L cid2

long

12041

二级类目ID

L cid2Name

String

木手串/把件

二级类目名称

L cid3

long

12052

三级类目ID

L cid3Name

String

其他

三级类目名称

L comments

long

999

评论数

commissionInfo

json

佣金信息

L commission

double

22.68

佣金

L commissionShare

double

50

佣金比例

L couponCommission

Double

12.68

券后佣金,(促销价-优惠券面额)*佣金比例

L plusCommissionShare

Double

50

plus佣金比例,plus用户购买推广者能获取到的佣金比例

L isLock

Integer

1

是否锁定佣金比例:1是,0否

L startTime

Long

1601364491000

计划开始时间(时间戳,毫秒)

L endTime

Long

1601364491062

计划结束时间(时间戳,毫秒)

couponInfo

json

优惠券信息,返回内容为空说明该SKU无可用优惠券

L couponList

json

优惠券合集

L coupon

json

优惠券合集

L bindType

ini

3

券种类 (优惠券种类:0 - 全品类,1 - 限品类(自营商品),2 - 限店铺,3 - 店铺限商品券)

L discount

double

30

券面额

L link

String

http://coupon.jd.com/ilink/couponActiveFront/front_index.action?XXXXXXX

券链接

L platformType

int

0

券使用平台 (平台类型:0 - 全平台券,1 - 限平台券)

L quota

double

39

券消费限额

L getStartTime

long

1532921782000

领取开始时间(时间戳,毫秒)

L getEndTime

long

1532921782000

券领取结束时间(时间戳,毫秒)

L useStartTime

long

1532921782000

券有效使用开始时间(时间戳,毫秒)

L useEndTime

long

1532921782000

券有效使用结束时间(时间戳,毫秒)

L isBest

Integer

1

1 最优优惠券,1:是;0:否,购买一件商品可使用的面额最大优惠券

L hotValue

Integer

5

券热度,值越大热度越高,区间:[0,10]

goodCommentsShare

double

99

商品好评率

imageInfo

json

图片信息

L imageList

json

图片合集

L urlInfo

json

图片合集

L url

String

http://img14.360buyimg.com/ads/jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg

图片链接地址,第一个图片链接为主图链接

L whiteImage

String

https://img14.360buyimg.com/pop/jfs/t1/74611/40/9199/226994/5d6f1c60E211d7a9e/e69c31469897a95a.png

白底图

inOrderCount30Days

long

6018

30天引单数量

seckillInfo

seckillInfo

秒杀信息

L seckillOriPrice

Double

36.9

秒杀价原价

L seckillPrice

Double

26.8

秒杀价

L seckillStartTime

Long

1574474399000

秒杀开始时间(时间戳,毫秒)

L seckillEndTime

Long

1574388000000

秒杀结束时间(时间戳,毫秒)

materialUrl

long

item.jd.com/26898778009.html

商品落地页

priceInfo

json

价格信息

L price

double

39.9

商品价格

L lowestPrice

Double

14.9

促销价

L lowestPriceType

Integer

2

促销价类型,1:无线价格;2:拼购价格; 3:秒杀价格

L lowestCouponPrice

Double

10.9

券后价(有无券都返回此字段)

L historyPriceDay

Double

180

历史最低价天数(例:当前券后价最近180天最低)

shopInfo

json

店铺信息

L shopName

String

XXXX旗舰店

店铺名称(或供应商名称

L shopId

long

45619

店铺Id

L shopLevel

Double

3.5

店铺评分

L shopLabel

String

1

1:京东好店 https://img12.360buyimg.com/schoolbt/jfs/t1/80828/19/2993/908/5d14277aEbb134d76/889d5265315e11ed.png

L userEvaluateScore

String

9.46

用户评价评分(仅pop店铺有值)

L commentFactorScoreRankGrade

String

用户评价评级(仅pop店铺有值)

L logisticsLvyueScore

String

9.69

物流履约评分(仅pop店铺有值)

L logisticsFactorScoreRankGrade

String

物流履约评级(仅pop店铺有值)

L afterServiceScore

String

8.98

售后服务评分(仅pop店铺有值)

L afsFactorScoreRankGrade

String

售后服务评级(仅pop店铺有值)

L scoreRankRate

String

94.36

店铺风向标(仅pop店铺有值)

skuId

long

26898778009

商品ID

skuName

String

便携式女士香水持久淡香小样 初见系列香水 遇见时光

商品名称

isHot

int

1

是否爆款,1:是,0:否

spuid

long

3491692

spuid,其值为同款商品的主skuid

brandCode

String

7998

品牌code

brandName

String

悍途(Humtto)

品牌名

owner

String

g

g=自营,p=pop

pinGouInfo

json

拼购信息

L pingouPrice

double

39.9

拼购价格

L pingouTmCount

long

2

拼购成团所需人数

L pingouUrl

String

https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=35097232463 from=cps

拼购落地页url

resourceInfo

json

资源信息

L eliteId

int

11

频道id

L eliteName

String

品牌好货-潮流范儿

频道名称

inOrderCount30DaysSku

long

100

30天引单数量(sku维度)

documentInfo

DocumentInfo

段子信息

段子信息

L document

String

温和亲肤的配方 洁净面部污垢 为肌肤添加补水保湿养分 泡沫绵密丰富 温润不易紧绷 弱酸性氨基酸系 含有自然成分 容易冲洗

描述文案

L discount

String

29.9碧素堂氨基酸洗面奶

优惠力度文案

videoInfo

VideoInfo

视频信息

L videoList

Video[]

视频集合

L video

Video

视频明细

L width

Integer

400

L high

Integer

300

L imageUrl

String

https://img.300hu.com/4c1f7a6atransbjngwcloud1oss/44128edd173016898433773569/imageSampleSnapshot/1555986468_406717890.100_2756.jpg

视频图片地址

L videoType

Integer

1

1:主图,2:商详

L playType

String

high

low:标清,high:高清

L duration

Integer

10

时长(单位:s)

L playUrl

String

https://vod.https://vod.300hu.com/4c1f7a6atransbjngwcloud1oss/44128edd173016898433773569/v.f20.mp4?dockingId=2bc88c56-a44d-45c4-99b4-d9b68557e4e9storageSource=3.com/4c1f7a6atransbjngwcloud1oss/44128edd173016898433773569/v.f20.mp4?dockingId=2bc88c56-a44d-45c4-99b4-d9b68557e4e9storageSource=3

播放地址

jxFlags

Integer[]

[1,2,3]

京喜商品类型,1京喜、2京喜工厂直供、3京喜优选(包含3时可在京东APP购买)

forbidTypes

Integer[]

[0,10,11]

0普通商品,10微信京东购物小程序禁售,11微信京喜小程序禁售

deliveryType

Integer

1

京东配送 1:是,0:不是

skuLabelInfo

SkuLabelInfo

商品标签

L is7ToReturn

Integer

1

0:不支持; 1或null:支持7天无理由退货; 2:支持90天无理由退货; 4:支持15天无理由退货; 6:支持30天无理由退货;

bookInfo

BookInfo

图书信息

L isbn

String

9787515515564

图书编号

total_results

long

100

有效商品总数量

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 200,
	"data": [{
			"brandCode": "444823",
			"brandName": "贝恩比(Beienbi)",
			"categoryInfo": {
				"cid1": 6233,
				"cid1Name": "玩具乐器",
				"cid2": 21813,
				"cid2Name": "戏水玩沙玩具",
				"cid3": 21878,
				"cid3Name": "玩沙玩具"
			},
			"comments": 18,
			"commissionInfo": {
				"commission": 1.18,
				"commissionShare": 20,
				"couponCommission": 0.98,
				"endTime": 1617119999000,
				"isLock": 1,
				"plusCommissionShare": 20,
				"startTime": 1616947200000
			},
			"couponInfo": {
				"couponList": [{
					"bindType": 3,
					"discount": 1,
					"getEndTime": 1617119998000,
					"getStartTime": 1616934165000,
					"isBest": 1,
					"link": "https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoe1Q8MujyQLHdEIvLSLPblu3N7rxT1lj9U6tmZojPmJ9LyVg3oPMg7Bf8ekfzM0-BdFLevbw",
					"platformType": 0,
					"quota": 5,
					"useEndTime": 1617119999000,
					"useStartTime": 1616860800000
				}]
			},
			"deliveryType": 0,
			"documentInfo": {
				"discount": "5.9?贝恩比决明子玩具套装",
				"document": "?这款儿童沙滩玩具套装?其拥有的桶?铲子等工具?可让宝宝在玩的同时也能尽情的发挥自己的想象力?而采用的12件套材质✨具有耐摔不易损坏的特点⭐让您放心的给孩子使用?"
			},
			"forbidTypes": [
				0
			],
			"goodCommentsShare": 100,
			"imageInfo": {
				"imageList": [{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/163473/21/14374/187454/605b12c8Ecef1bc3d/4d4a3a75b3f03656.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/167451/32/12677/172720/604f12e0E247342a2/f61ce566f3160482.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/162235/17/12886/144197/604f12e0E06766517/9580ab3a7a1be9a6.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/155943/4/15937/179869/604f12e0E4166d9c1/6c1688c83c7e9c15.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/169202/19/12790/127847/604f12e1Ee810a12a/58870a8b81cf6d4c.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/164531/4/12857/123102/604f12e1E0eea1d55/f2571381a009ee1b.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/162475/11/12616/76756/604f12e1E3f8301a4/5437afccc7960df0.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/163822/40/12414/117951/604f12e1E4a534239/64caab6248dacc5f.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/168130/25/12328/135632/604f12e1Ee58c400d/5463b1b2df215176.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/156671/31/16019/80787/604f12e1E90ae5b89/80c85a801dce46f2.jpg"
					}
				],
				"whiteImage": "https://img14.360buyimg.com/pop/jfs/t1/170490/25/12598/128101/604f1305E589f5dcf/cb076b8bf00ed0f3.png"
			},
			"inOrderCount30Days": 25202,
			"inOrderCount30DaysSku": 24765,
			"isHot": 1,
			"jxFlags": [
				1
			],
			"materialUrl": "item.jd.com/10027755471101.html",
			"owner": "p",
			"pinGouInfo": {
				"pingouEndTime": 2133999048000,
				"pingouPrice": 5.9,
				"pingouStartTime": 1615795496000,
				"pingouTmCount": 2,
				"pingouUrl": "https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=10027755471101&from=cps"
			},
			"priceInfo": {
				"lowestCouponPrice": 4.9,
				"lowestPrice": 5.9,
				"lowestPriceType": 2,
				"price": 45.8
			},
			"resourceInfo": {
				"eliteId": 22,
				"eliteName": "精品库"
			},
			"shopInfo": {
				"shopId": 10425196,
				"shopLabel": "0",
				"shopLevel": 0,
				"shopName": "贝恩比拼购专卖店"
			},
			"skuId": 10027755471101,
			"skuLabelInfo": {
				"fxgServiceList": [],
				"is7ToReturn": 1
			},
			"skuName": "【春上新】贝恩比 儿童沙滩玩具套装宝宝戏水沙漏玩沙挖沙决明子大号铲子沙滩桶工具 沙滩桶12件套",
			"spuid": 10027755471100
		},
		{
			"brandCode": "337033",
			"brandName": "馨语(xinyu)",
			"categoryInfo": {
				"cid1": 15901,
				"cid1Name": "家庭清洁/纸品",
				"cid2": 15902,
				"cid2Name": "清洁纸品",
				"cid3": 15909,
				"cid3Name": "卷纸"
			},
			"comments": 45412,
			"commissionInfo": {
				"commission": 1.18,
				"commissionShare": 20,
				"couponCommission": 0.98,
				"endTime": 1617206399000,
				"isLock": 1,
				"plusCommissionShare": 20,
				"startTime": 1616688000000
			},
			"couponInfo": {
				"couponList": [{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616582548000,
						"hotValue": 3,
						"isBest": 1,
						"link": "http://coupon.m.jd.com/coupons/show.action?key=7d61f0073a594f8c821cf45488cdb47e&roleId=48385679&to=item.jd.com",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616582825000,
						"hotValue": 4,
						"isBest": 0,
						"link": "https://coupon.jd.com/ilink/couponActiveFront/front_index.action?key=d7c2612dd2ac49eea5627be465a5bdb9&roleId=48385809&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616642796000,
						"isBest": 0,
						"link": "http://coupon.m.jd.com/coupons/show.action?key=535f7e061b5d438ca904d94a36da4ece&roleId=48413034&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616601600000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616595707000,
						"hotValue": 4,
						"isBest": 0,
						"link": "http://coupon.m.jd.com/coupons/show.action?key=106b49becbc54ccea249c573e38a9561&roleId=48393080&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616595310000,
						"hotValue": 0,
						"isBest": 0,
						"link": "https://coupon.jd.com/ilink/couponActiveFront/front_index.action?key=e9dfdb7ab146437d894482e492376c09&roleId=48392942&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616595013000,
						"hotValue": 0,
						"isBest": 0,
						"link": "https://coupon.jd.com/ilink/couponActiveFront/front_index.action?key=d879003c182c498ea0aa58943a86cf8c&roleId=48392749&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616595119000,
						"hotValue": 0,
						"isBest": 0,
						"link": "https://coupon.jd.com/ilink/couponActiveFront/front_index.action?key=d7aeb6b9d5364aa1af9e403e31aa5db6&roleId=48392826&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					},
					{
						"bindType": 3,
						"discount": 1,
						"getEndTime": 1617206339000,
						"getStartTime": 1616595595000,
						"hotValue": 3,
						"isBest": 0,
						"link": "https://coupon.jd.com/ilink/couponActiveFront/front_index.action?key=1bb5b7b8de1b4da88b42471f63c046b2&roleId=48393022&to=item.jd.com/60927997266.html",
						"platformType": 0,
						"quota": 5,
						"useEndTime": 1617206399000,
						"useStartTime": 1616515200000
					}
				]
			},
			"deliveryType": 0,
			"documentInfo": {
				"discount": "5.9?馨语卫生纸竹浆本色卷纸",
				"document": "?精选优质原生竹浆?天然无刺激?使用更安全放心?防潮?防霉?耐磨?不易破的特点?让你用起来更加的安心和健康?采用的是环保的材料✨没有任何的异味?不会伤害皮肤⭐给家人带来全新的体验?"
			},
			"forbidTypes": [
				0
			],
			"goodCommentsShare": 97,
			"imageInfo": {
				"imageList": [{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/168872/30/14556/614207/605b11f1Ec287c5bc/c98af02d73f64bcc.png"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/100106/29/2270/153564/5dcd4a0fEc2608cba/171f44af49fbc9d9.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/71065/36/11533/114191/5d8daf0fEedb15c92/46ea82dd0fab2662.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/80985/25/11445/99147/5d8dae55E88370664/7242efddf77bc8cc.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/63622/29/11390/115761/5d8dae55E0f8a96f2/de153f951e2df78f.jpg"
					},
					{
						"url": "https://img14.360buyimg.com/pop/jfs/t1/102560/27/2276/118181/5dcd4a0fE308048c7/3b124a1b7c2379cd.jpg"
					}
				],
				"whiteImage": "https://img14.360buyimg.com/pop/jfs/t1/63703/30/15323/558724/5dcd4a27Eafd55ec4/7b2227be8b97ec79.png"
			},
			"inOrderCount30Days": 15982,
			"inOrderCount30DaysSku": 15740,
			"isHot": 1,
			"jxFlags": [
				1,
				2,
				3
			],
			"materialUrl": "item.jd.com/60927997266.html",
			"owner": "p",
			"pinGouInfo": {
				"pingouEndTime": 2133999048000,
				"pingouPrice": 5.9,
				"pingouStartTime": 1572850473000,
				"pingouTmCount": 2,
				"pingouUrl": "https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=60927997266&from=cps"
			},
			"priceInfo": {
				"historyPriceDay": 180,
				"lowestCouponPrice": 4.9,
				"lowestPrice": 5.9,
				"lowestPriceType": 2,
				"price": 22.9
			},
			"resourceInfo": {
				"eliteId": 22,
				"eliteName": "精品库"
			},
			"shopInfo": {
				"shopId": 10110650,
				"shopLabel": "0",
				"shopLevel": 0,
				"shopName": "馨语硅流拼购专卖店"
			},
			"skuId": 60927997266,
			"skuLabelInfo": {
				"fxgServiceList": [],
				"is7ToReturn": 1
			},
			"skuName": "【春上新】馨语卷纸【16卷/提】4层纯原生竹浆本色卷纸天然本色系列卫生纸厕纸纸巾 16卷",
			"spuid": 60927997266
		}
	]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。