商品URL链接/关键词/类目/相似推荐查询/商品ID查询优惠券列表接口,京东超级搜索接口
13413人使用

查询商品及优惠券信息,返回的结果可调用转链接口生成单品或二合一推广链接。支持按SKUID、关键词、优惠券基本属性、是否拼购、是否爆款等条件查询,建议不要同时传入SKUID和其他字段,以获得较多的结果。支持按价格、佣金比例、佣金、引单量等维度排序

京东商品会返回多个券,有些券是满减券不可以直接使用,要判断返回券中的字段最优优惠券isBest=1,或者券消费限额 quoat < 商品价格

接口地址: http://api.tbk.dingdanxia.com/jd/query_goods 在线测试

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

cid1

Long

737

一级类目id

cid2

Long

738

二级类目id

cid3

Long

739

三级类目id

pageIndex

Integer

1

页码

pageSize

Integer

20

每页数量,单页数最大30,默认20

skuIds

Long[]

5225346,7275691

skuid集合(一次最多支持查询100个sku,逗号分割)

keyword

String

手机/https://item.jd.com/23848769472.html

关键词/商品URL链接,字数同京东商品名称一致,目前未限制

pricefrom

Double

16.88

商品价格下限制

priceto

Double

19.85

商品价格上限

commissionShareStart

Integer

10

佣金比例区间开始

commissionShareEnd

Integer

50

佣金比例区间结束

owner

String

g

商品类型:自营[g],POP[p]

sortName

String

price

排序字段(price:单价, commissionShare:佣金比例, commission:佣金, inOrderCount30Days:30天引单量, inOrderComm30Days:30天支出佣金)

sort

String

desc

asc,desc升降序,默认降序

isCoupon

Integer

1

是否是优惠券商品,1:有优惠券,0:无优惠券

isPG

Integer

1

是否是拼购商品,1:拼购商品,0:非拼购商品

pingouPriceStart

Double

16.88

拼购价格区间开始

pingouPriceEnd

Double

19.95

拼购价格区间结束

isHot

Integer

1

是否是爆款,1:爆款商品,0:非爆款商品

brandCode

String

7998

品牌code

shopId

Integer

45619

店铺Id

hasContent

Integer

1

1:查询内容商品;其他值过滤掉此入参条件。

hasBestCoupon

Integer

1

1:查询有最优惠券商品;其他值过滤掉此入参条件。

pid

String

618_618_618

联盟id_应用iD_推广位id

fields

String

videoInfo

支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息),commentInfo(评论信息),hotWords(热词),similar(相似推荐商品)

forbidTypes

String

2,3,5

过滤规则,入参表示不展示该规则数据,支持多个逗号','分隔,2:OTC商品;3:加油卡;4:游戏充值卡;5:合约机;6:京保养;7:虚拟组套;8:定制商品

jxFlags

Integer

1

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

shopLevelFrom

Double

3.5

支持传入0.0、2.5、3.0、3.5、4.0、4.5、4.9,默认为空表示不筛选评分

返回参数说明

标记

类型

例子

说明

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 couponCommission

double

20.22

佣金(按券后价计算)

L commissionShare

double

50

佣金比例

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

int

1

最优优惠券,1:是;0:否

goodCommentsShare

double

99

商品好评率

imageInfo

json

图片信息

imageList

json

图片合集

urlInfo

json

图片合集

L url

String

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

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

inOrderCount30Days

long

6018

30天引单数量

materialUrl

long

item.jd.com/26898778009.html

商品落地页

priceInfo

json

价格信息

L price

double

39.9

无线价格

L lowestPrice

double

14.9

最低价格

L lowestPriceType

int

2

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

L lowestCouponPrice

double

10.9

最低价后的优惠券价最低价后的优惠券价(当商品无最优券时,不返回该字段)

shopInfo

json

店铺信息

L shopName

String

XXXX旗舰店

店铺名称(或供应商名称

L shopId

long

45619

店铺Id

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

L pingouStartTime

long

1546444800000

拼购开始时间(时间戳,毫秒)

L pingouEndTime

long

1548604800000

拼购结束时间(时间戳,毫秒)

total_results

long

6186186

有效商品总数量,上限10w

similarSkuList

Long[]

[11144230,11993134]

相似推荐商品skuId集合,需要传skuIds

hotWords

String

牛奶,家电

日常top10的热搜词,按小时更新

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 1918709,
	"data": [{
		"brandCode": "250686",
		"brandName": "传奇保罗(CHUANQIBAOLUO)",
		"categoryInfo": {
			"cid1": 1315,
			"cid1Name": "服饰内衣",
			"cid2": 1342,
			"cid2Name": "男装",
			"cid3": 1349,
			"cid3Name": "T恤"
		},
		"comments": 13,
		"commissionInfo": {
			"commission": 15.8,
			"commissionShare": 20
		},
		"couponInfo": {
			"couponList": [{
				"bindType": 3,
				"discount": 30,
				"getEndTime": 1572928500000,
				"getStartTime": 1566707700000,
				"isBest": 1,
				"link": "http://coupon.jd.com/ilink/couponActiveFront/front_index.action?key=f9f6fc7a00864f289bf2a1b0db17c6e2&roleId=22458616&to=item.jd.com/55385038918.html#crumb-wrap",
				"platformType": 0,
				"quota": 79,
				"useEndTime": 1572969599000,
				"useStartTime": 1566662400000
			}]
		},
		"goodCommentsShare": 100,
		"imageInfo": {
			"imageList": [{
				"url": "http://img14.360buyimg.com/ads/jfs/t1/39034/2/15187/190547/5d613f32E1c3f19ef/b306aa107ef35e0a.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/53116/28/8788/266764/5d613f31Edbf58614/7092d7e11c9fe3f9.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/73630/32/8194/230317/5d613f30E7b3e4a7f/f52ebe7e2e360532.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/41210/23/13017/249867/5d613f30E071b5fc1/b2938d46160ed5fd.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/74978/34/8278/236775/5d613f31Ea05ab457/5b62afbb2b4cddc2.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/63608/13/8201/150536/5d613f31E883e3b6f/bad15ae1f2cda536.jpg"
			}]
		},
		"inOrderComm30Days": 351.69,
		"inOrderCount30Days": 42,
		"isHot": 1,
		"isJdSale": 0,
		"materialUrl": "item.jd.com/55385038917.html",
		"owner": "p",
		"pinGouInfo": [],
		"pingGouInfo": [],
		"priceInfo": {
			"lowestPrice": 79,
			"lowestPriceType": 1,
			"price": 79
		},
		"shopInfo": {
			"shopId": 712731,
			"shopName": "普拉鹿达服饰专营店"
		},
		"skuId": 55385038917,
		"skuName": "传奇保罗长袖T恤男士2019秋冬季新品韩版潮动漫t恤宽松休闲衣服青少年卫衣上衣男 灰色 L",
		"spuid": 55385038906
	}, {
		"brandCode": "465840",
		"brandName": "健如山(JIANRUSHAN)",
		"categoryInfo": {
			"cid1": 1315,
			"cid1Name": "服饰内衣",
			"cid2": 1342,
			"cid2Name": "男装",
			"cid3": 1349,
			"cid3Name": "T恤"
		},
		"comments": 2651,
		"commissionInfo": {
			"commission": 0.1,
			"commissionShare": 10
		},
		"couponInfo": {
			"couponList": []
		},
		"goodCommentsShare": 75,
		"imageInfo": {
			"imageList": [{
				"url": "http://img14.360buyimg.com/ads/jfs/t1/46201/4/8189/126035/5d5b6542Ee26e001f/e9ddf2f62b5ab916.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/59229/23/8062/61737/5d5b6542Eba631788/be4a98eaecac38dd.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/61311/20/7728/93032/5d5b6542E28b0fd41/bbb61309bae3cb7e.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/50441/10/8156/67018/5d5b6542Efe63d0ac/094f603ead846dbc.jpg"
			}, {
				"url": "http://img14.360buyimg.com/ads/jfs/t1/80379/2/7812/109473/5d5b654aE265957c2/146a31eb21918fec.jpg"
			}]
		},
		"inOrderComm30Days": 106.99,
		"inOrderCount30Days": 2018,
		"isHot": 1,
		"isJdSale": 0,
		"materialUrl": "item.jd.com/55080419376.html",
		"owner": "p",
		"pinGouInfo": {
			"pingouEndTime": 2133999048000,
			"pingouPrice": 1,
			"pingouStartTime": 1566270920000,
			"pingouTmCount": 2,
			"pingouUrl": "https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=55080419376&from=cps"
		},
		"pingGouInfo": {
			"pingouPrice": 1,
			"pingouTmCount": 2,
			"pingouUrl": "https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=55080419376&from=cps"
		},
		"priceInfo": {
			"lowestPrice": 1,
			"lowestPriceType": 2,
			"price": 58
		},
		"shopInfo": {
			"shopId": 10071552,
			"shopName": "健如山服饰拼购旗舰店"
		},
		"skuId": 55080419376,
		"skuName": "春秋季纯棉男士长袖t恤韩版打底衫青年秋衣大码男装上衣服体恤男士衫 长袖AGA M码 155-165CM",
		"spuid": 55080419375
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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