2）实时热搜榜信息 - 消息服务总线3.0在线接口文档

请求参数

Header 参数

appKey

string

AppKey

必需

nonce

string

随机数

必需

timestamp

string

时间戳

必需

signature

string

必需

签名，详见附件客户签名生成工具类

Body 参数application/json

实时热搜入参

type

integer <int32>

必需

渠道类型【1-微博、2-抖音、3-百度、4-头条、5-知乎、7-快手、9-小红书、10-B站、11-QQ音乐】

topNum

integer <int32>

可选

TOP榜单条数【默认10条,最大100条】

>= 1<= 100

默认值:

10

isExtended

boolean

可选

是否扩展字段【默认不返回，true-需要、false-不需要】

示例

{
  "type": 0,
  "topNum": 10,
  "isExtended": true
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/hotRank/getHotRank' \
--header 'appKey;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": 0,
    "topNum": 10,
    "isExtended": true
}'

返回响应

🟢200OK

application/json

Body

返回数据格式

code

integer <int32>

可选

响应码【200代表成功,其他参见错误码值表】)

success

boolean

可选

是否成功【true代表成功,false代表失败】

message

string

响应消息

可选

data

array[object (HotRankVO) {16}]

响应数据

可选

title

string

文章标题

可选

url

string

文章链接地址

可选

topId

integer <int32>

排名

可选

heatIndex

integer <int64>

热度值

可选

type

integer <int32>

可选

渠道类型【1-微博、2-抖音、3-百度、4-头条、5-知乎、7-快手、9-小红书、10-B站、11-QQ音乐】

listType

integer <int32>

必需

榜单类型【1-热搜榜、2-视频榜、3-同城榜、4-(qq音乐)飙升榜、5-(qq音乐)热歌榜】

rankingChanges

integer <int32>

榜单排名变化

可选

firstInsertTime

string

首次上榜时间

可选

onListTime

integer <int64>

可选

在榜时长，单位：分钟

insertTime

string

采集时间

可选

uuid

string

uuid

可选

uniqueId

string

唯一ID值

可选

label

string

标签

可选

expand

object (ExpandVO)

可选

热榜扩展字段【各个渠道字段详见字段描述说明】

firstRanking

integer <int32>

首次榜单排名

可选

historyMaxRanking

integer <int32>

历史榜单排名最大值

可选

errors

array[string]

错误信息集合

可选

time

string <date-time>

响应时间

可选

示例

{
  "code": 0,
  "success": true,
  "message": "string",
  "data": [
    {
      "title": "string",
      "url": "string",
      "topId": 0,
      "heatIndex": 0,
      "type": 0,
      "listType": 0,
      "rankingChanges": 0,
      "firstInsertTime": "string",
      "onListTime": 0,
      "insertTime": "string",
      "uuid": "string",
      "uniqueId": "string",
      "label": "string",
      "expand": {
        "author": "string",
        "viewCount": 0,
        "followerCount": 0,
        "visitsCount": 0,
        "cover": "string",
        "summary": "string",
        "readCount": 0,
        "commentCount": 0,
        "interactionCount": 0,
        "originalCount": 0,
        "read24h": 0,
        "comment24h": 0,
        "interaction24h": 0,
        "original24h": 0,
        "read30d": 0,
        "comment30d": 0,
        "interaction30d": 0,
        "original30d": 0,
        "duration": 0,
        "publishTime": "string",
        "topicName": "string"
      },
      "firstRanking": 0,
      "historyMaxRanking": 0
    }
  ],
  "errors": [
    "string"
  ],
  "time": "2019-08-24T14:15:22Z"
}