京东物料/猜你喜欢/实时热销/大额券/9.9元/商品库/商品查询
8721人使用

输入物料id,获取对应的商品信息,目前联盟推荐的精选商品库,包含猜你喜欢、实时热销、大额券、商品库、9.9等各种实时数据,适用于toc搭建频道页,千人千面商品推荐模块场景

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

eliteId

int

1

频道ID:1.猜你喜欢、2.实时热销、3.大额券、4.9.9包邮、5.1001选品库

pageIndex

int

1

页码

pageSize

int

10

每页数量,最大10

pid

String

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

subUnionId

String

618_18_c35***e6a

子联盟ID(需申请,申请方法请见https://union.jd.com/helpcenter/13246-13247-46301),该字段为自定义参数,建议传入字母数字和下划线的格式

siteId

String

435676

站点ID是指在联盟后台的推广管理中的网站Id、APPID(1、通用转链接口禁止使用社交媒体id入参;2、订单来源,即投放链接的网址或应用必须与传入的网站ID/AppID备案一致,否则订单会判“无效-来源与备案网址不符”

positionId

String

1

推广位id

ext1

String

100_618_618

系统扩展参数,无需传入

skuId

long

1111

预留字段,请勿传入

hasCoupon

int

1

1:只查询有最优券商品,不传值不做限制

userIdType

int

32

用户ID类型,传入此参数可获得个性化推荐结果,32:苹果移动设备idfa,32768:android oaid

userId

String

6D18**-**-**-**-****

userIdType对应的用户设备ID,传入此参数可获得个性化推荐结果

fields

String

videoInfo

支持出参数据筛选,逗号','分隔,目前可用:videoInfo(视频信息)

forbidTypes

String

10,11

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

orderId

String

108618000005

用户京东联盟订单号(先取订单号,如果订单号未命中、设备号命中,则以设备号为准)

groupId

Number

1

选品库id(仅对eliteId=1001有效,且必传)

ownerUnionId

Number

5227

groupId创建者的UnionId

benefitType

Number

1

类型 0:选品库

返回参数说明

标记

类型

例子

说明

categoryInfo

CategoryInfo

类目信息

L cid1

long

6144

一级类目ID

L cid1Name

String

珠宝首饰

一级类目名称

L cid2

long

12041

二级类目ID

L cid2Name

String

木手串/把件

二级类目名称

L cid3

long

12052

三级类目ID

L cid3Name

String

其他

三级类目名称

comments

long

999

评论数

L commissionInfo

CommissionInfo

佣金信息

L commission

double

22.68

佣金

L commissionShare

double

50

佣金比例

L couponCommission

double

12.68

券后佣金

L plusCommissionShare

double

50

plus佣金比例

couponInfo

CouponInfo

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

L couponList

Coupon[]

优惠券合集

L coupon

coupon

优惠券合集

L bindType

int

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

ImageInfo

图片信息

L imageList

UrlInfo[]

图片合集

L urlInfo

UrlInfo

图片合集

L url

String

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

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

inOrderCount30Days

long

6018

30天引单数量

priceInfo

PriceInfo

价格信息

L price

double

39.9

无线价格

L lowestPrice

double

14.9

最低价格

L lowestPriceType

int

2

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

L lowestCouponPrice

double

10.9

最低价后的优惠券价

shopInfo

shopInfo

店铺信息

L shopName

String

XXXX旗舰店

店铺名称(或供应商名称)

L shopId

long

45619

店铺Id

L shopLevel

double

3.5

店铺评分

skuId

long

26898778009

商品ID

skuName

String

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

商品名称

isHot

int

1

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

spuid

long

3491692

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

brandCode

String

悍途(Humtto)

品牌名

owner

String

g

g=自营,p=pop

pinGouInfo

PinGouInfo

拼购信息

L pingouPrice

double

39.9

拼购价格

L pingouTmCount

long

2

拼购成团所需人数

L pingouStartTime

long

1569224455000

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

L pingouEndTime

long

2133999048000

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

resourceInfo

ResourceInfo

资源信息

L eliteId

int

11

频道id

L eliteName

String

品牌好货-潮流范儿

频道名称

inOrderCount30DaysSku

long

100

30天引单数量(sku维度)

seckillInfo

SeckillInfo

秒杀信息

L seckillOriPrice

double

36.9

秒杀价原价

L seckillPrice

double

26.8

秒杀价

L seckillStartTime

long

1574474399000

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

L seckillEndTime

long

1574388000000

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

jxFlags

int[]

[1,2,3]

京喜商品类型,1京喜、2京喜工厂直供、3京喜优选

videoInfo

VideoInfo

视频信息

L videoList

Video[]

视频集合

L video

Video

视频集合

L width

int

400

L high

int

300

L imageUrl

String

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

视频图片地址

L videoType

int

1

1:主图,2:商详

L playType

String

high

low:标清,high:高清

L duration

int

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

播放地址

promotionInfo

promotionInfo

推广信息

L clickURL

String

https://union-xxx

长链推广

total_results

long

100

有效商品总数量

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "total_results":189,
    "data":[
        {
            "brandCode":"213316",
            "brandName":"百寿元(baishouyuan)",
            "categoryInfo":{
                "cid1":1320,
                "cid1Name":"食品饮料",
                "cid2":1584,
                "cid2Name":"粮油调味",
                "cid3":2677,
                "cid3Name":"调味品"
            },
            "comments":6312,
            "commissionInfo":{
                "commission":3.98,
                "commissionShare":20,
                "couponCommission":1.98,
                "plusCommissionShare":20
            },
            "couponInfo":{
                "couponList":[
                    {
                        "bindType":3,
                        "discount":10,
                        "getEndTime":1596211190000,
                        "getStartTime":1594828800000,
                        "isBest":1,
                        "link":"https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoeRAz5O81dD4qMuw9RLtCgEj3CYDmAp8CH8OU8RTYODjZqbz6wxfDwHNSHk6DwuI4E3gwU4Q",
                        "platformType":0,
                        "quota":19,
                        "useEndTime":1596211199000,
                        "useStartTime":1594828800000
                    }
                ]
            },
            "goodCommentsShare":99,
            "imageInfo":{
                "imageList":[
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/119098/10/5252/184766/5eb27bfeE45b96867/25323fdd66edf577.jpg"
                    },
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/115201/22/5119/167338/5eb255feE47a5da49/f5ef23211f04b704.jpg"
                    },
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/118036/29/5202/119135/5eb255feE8df8d109/a462ca86c7c2a55e.jpg"
                    },
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/108299/32/16434/85107/5eb255feEaf3804ef/055b62d279e768eb.jpg"
                    },
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/111348/37/5224/52193/5eb255feE255ac8ac/8e74d235febfb6ed.jpg"
                    },
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/112315/16/5163/144791/5eb255feE3373242e/9cc21fefe57506cd.jpg"
                    },
                    {
                        "url":"http://img14.360buyimg.com/pop/jfs/t1/119576/22/3792/172660/5eb255feE1e3e508d/3b71d793175808a4.jpg"
                    }
                ]
            },
            "inOrderCount30Days":3050,
            "inOrderCount30DaysSku":3050,
            "isHot":1,
            "owner":"p",
            "pinGouInfo":[
            ],
            "priceInfo":{
                "lowestCouponPrice":9.9,
                "lowestPrice":19.9,
                "lowestPriceType":1,
                "price":19.9
            },
            "promotionInfo":{
                "clickURL":"https://union-click.jd.com/jdc?e=&p=AyIGZRprEgsaDlUcXRAHGgNlXwRNXE03DF4eVEAZGUtDHkFeDVtKQA4KUExbS1oYS1dWVRAFXBwKGwdSHV4QChYYDF4HSDJ7RlJzHGdKQmVTUygSZhoPEGEcd2ByC1krWiUCEwZUH1gVBRQAZStbFTJZaVQrWiUCFg9REl4VARAFVhhbJQETBWVBDEdeUDdlK1glMiIHZRhrVmwXaQt1WkYBQVMAHAh7WEcCBUVaHFp8BVEYWRUCEQZlGVoUAhs%3D"
            },
            "resourceInfo":{
                "eliteId":4,
                "eliteName":"9.9"
            },
            "shopInfo":{
                "shopId":208859,
                "shopLevel":4.9,
                "shopName":"百寿元旗舰店"
            },
            "skuId":68981674495,
            "skuName":"【爆款推荐】百寿元红糖老红糖月经产妇月子手工土红糖块经期老红糖大姨妈黑糖块200g",
            "spuid":68981674495,
            "videoInfo":[
            ]
        }
    ]
}
			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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