京东实时热销榜商品接口
需要授权
102人使用

联盟实时热销榜商品接口,支持榜单Id和排序类型查询榜单商品列表

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

rankId

Number

200001

榜单ID(200000:全部,200001:食品酒水,200002:家庭清洁,200003:个护美妆,200004:医药保健,200005:生鲜,200006:数码家电,200007:家居日用,200008:时尚生活)

sortType

Number

2

排序类型( 1:2小时,2:高佣,3:24小时)

pageIndex

Number

1

页码

pageSize

Number

10

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

返回参数说明

标记

类型

例子

说明

itemId

String

Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF

联盟商品ID

skuId

Number

26898778009

商品skuId

skuName

String

笔记本

商品名称

imageUrl

String

商品主图

wlprice

Number

100

基准价

commissionShare

Number

5

佣金比例

comments

Number

30

评论总数

goodComments

Number

15

好评数

goodCommentsShare

String

99

好评率

skuTagList

SkuTagInfo[]

联盟标签

purchasePriceInfo

RankPurchasePriceInfo

到手价

couponList

RankCoupon[]

优惠券集合

discount

Number

券面额

quota

Number

39

券消费限额

remainCnt

Number

1000

券剩余数量

couponStyle

Number

0

优惠券分类 0:满减券,3:满折券,28: 每满减券

couponStatus

Number

-1

领取状态。0: 正常可领, -1 :不可领取, 1: 已领取

timeCouponInfoList

TimeCouponInfo[]

时段券信息集合

timeCouponBegin

String

00:00:00

时段券领取开始时间

timeCouponEnd

String

08:59:59

时段券领取结束时间

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "total_results": 100,
    "data": [
        {
            "comments": 90,
            "commission": 0.99,
            "commissionShare": 30.1,
            "goodComments": 90,
            "goodCommentsShare": 100,
            "imageUrl": "https://img14.360buyimg.com/pop/jfs/t1/303631/33/25586/99401/6899aa83F57646829/4137453e586b046c.jpg",
            "imgList": [
                "https://img14.360buyimg.com/pop/jfs/t1/303631/33/25586/99401/6899aa83F57646829/4137453e586b046c.jpg",
                "https://img14.360buyimg.com/pop/jfs/t1/308844/21/23040/80487/68933665F4be8b962/47f2339f74212da4.jpg",
                "https://img14.360buyimg.com/pop/jfs/t1/312415/36/23376/57404/68933666F054b242a/c9d0e3220a5ec70f.jpg",
                "https://img14.360buyimg.com/pop/jfs/t1/315198/25/23162/95316/68933666Fc194effc/0d70feea2366d929.jpg",
                "https://img14.360buyimg.com/pop/jfs/t1/299495/38/26544/52446/68933666Fb328530b/a2191f171cdbd33d.jpg"
            ],
            "itemId": "yrQ0Z8VaauVPn31c4vWOFDnI_3ghOcnpZwaAeop8Y0Y",
            "purchasePriceInfo": {
                "purchasePrice": 3.29
            },
            "skuName": "芒果干原切果脯办公室休闲零食酸甜果脯蜜饯精选 l净含量 芒果干50g*1袋",
            "skuTagList": [
                {
                    "index": 1,
                    "name": "京喜",
                    "type": 5
                },
                {
                    "index": 3,
                    "name": "7天无理由退货",
                    "type": 12
                },
                {
                    "index": 3,
                    "name": "超值|90天最低价",
                    "type": 4
                }
            ],
            "wlprice": 3.29
        },
        {
            "comments": 100,
            "commission": 0.16,
            "commissionShare": 3.1,
            "goodComments": 95,
            "goodCommentsShare": 100,
            "imageUrl": "https://img14.360buyimg.com/pop/jfs/t20260623/291079/9/13421/1089654/685952c5Fac748478/7dc27783476e7e99.png",
            "imgList": [
                "https://img14.360buyimg.com/pop/jfs/t20260623/291079/9/13421/1089654/685952c5Fac748478/7dc27783476e7e99.png",
                "https://img14.360buyimg.com/pop/jfs/t1/308821/1/7418/73555/6842a540F0f45d608/a12768407ada631e.jpg",
                "https://img14.360buyimg.com/pop/jfs/t1/318279/31/6894/170024/6842a541F6d159744/677e46b46717ef41.jpg"
            ],
            "itemId": "GJxdmGPbbAPtmr1v9wSHLT99_3CVJIOCmbbqVok1vIf",
            "purchasePriceInfo": {
                "purchasePrice": 5
            },
            "skuName": "小麻花独立包装酥脆网红充饥零食美食 多口味小麻花【30包】",
            "skuTagList": [
                {
                    "index": 1,
                    "name": "京喜",
                    "type": 5
                },
                {
                    "index": 3,
                    "name": "7天无理由退货",
                    "type": 12
                }
            ],
            "wlprice": 5
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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