获取京东推广商品信息接口
19074人使用

通过SKUID查询推广商品的名称、主图、类目、价格、物流、是否自营、30天引单数量等详细信息,支持批量获取。通常用于在媒体侧展示商品详情。

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

skuIds

String

5225346,7275691

京东skuID串,逗号分割,最多100个(非常重要 请大家关注:如果输入的sk串中某个skuID的商品不在推广中[就是没有佣金],返回结果中不会包含这个商品的信息

返回参数说明

标记

类型

例子

说明

skuId

long

61861866

商品id

unitPrice

double

89

商品单价即京东价

materialUrl

String

http://item.jd.com/10000000.html

商品落地页

endDate

long

32472115200000

推广结束日期(时间戳,毫秒)

isFreeFreightRisk

int

0

是否支持运费险(1:是,0:否)

isFreeShipping

int

1

是否包邮(1:是,0:否,2:自营商品遵从主站包邮规则)

commisionRatioWl

double

25

无线佣金比例

commisionRatioPc

double

25

PC佣金比例

imgUrl

String

http://img14.360buyimg.com/n1/jfs/t18901/86/XXXXXXXX/498446/725fedfc/5af7c7e1N8b133379.jpg

图片地址

vid

long

16815866

商家ID

cidName

String

母婴

一级类目名称

wlUnitPrice

double

89

商品无线京东价(单价为-1表示未查询到该商品单价)

cid2Name

String

童装

二级类目名称

isSeckill

int

0

是否秒杀(1:是,0:否)

cid2

long

11842

二级类目ID

cid3Name

String

裙子

三级类目名称

inOrderCount

long

703

30天引单数量

cid3

long

11225

三级类目ID

shopId

long

168168

店铺ID

isJdSale

int

1

是否自营(1:是,0:否)

goodsName

String

童装女童连衣裙儿童裙子大童女装2018夏季新品公主裙 横条纹款 130码(正码)

商品名称

startDate

long

1529251200000

推广开始日期(时间戳,毫秒)

cid

long

1319

一级类目ID

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": [{
		"unitPrice": 29.9,
		"materialUrl": "http:\/\/item.jd.com\/42302338454.html",
		"endDate": 32472115200000,
		"isFreeFreightRisk": 0,
		"isFreeShipping": 0,
		"commisionRatioWl": 20,
		"commisionRatioPc": 20,
		"imgUrl": "http:\/\/img14.360buyimg.com\/n1\/jfs\/t1\/39655\/3\/9001\/181393\/5d6616daE52871cc0\/e0701f6fba7fe42a.jpg",
		"vid": 10082919,
		"cidName": "医药保健",
		"wlUnitPrice": 29.9,
		"cid2Name": "保健器械",
		"isSeckill": 0,
		"cid2": 9197,
		"cid3Name": "家庭护理",
		"inOrderCount": 32,
		"cid3": 2687,
		"shopId": 10082919,
		"isJdSale": 0,
		"goodsName": "妇炎洁 植物本草抑菌洗液女性私处护理液清洗液 680ml(赠送冲洗器)",
		"skuId": 42302338454,
		"startDate": 1570809600000,
		"cid": 9192
	}, {
		"unitPrice": 6299,
		"materialUrl": "http:\/\/item.jd.com\/5225346.html",
		"endDate": 1577721600000,
		"isFreeFreightRisk": 0,
		"isFreeShipping": 2,
		"commisionRatioWl": 1,
		"commisionRatioPc": 1,
		"imgUrl": "http:\/\/img14.360buyimg.com\/n1\/jfs\/t1\/19909\/19\/2981\/167543\/5c231ea8Ed0bfe0c0\/f3fb909386a790a4.jpg",
		"vid": 1000000127,
		"cidName": "电脑、办公",
		"wlUnitPrice": 6299,
		"cid2Name": "电脑整机",
		"isSeckill": 0,
		"cid2": 671,
		"cid3Name": "笔记本",
		"inOrderCount": 16510,
		"cid3": 672,
		"shopId": 1000000127,
		"isJdSale": 1,
		"goodsName": "Apple MacBook Air 13.3 | Core i5 8G 128G SSD 笔记本电脑 轻薄本 银色 MQD32CH\/A",
		"skuId": 5225346,
		"startDate": 1568649600000,
		"cid": 670
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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