3）同城-热搜榜信息检索 - 消息服务总线3.0在线接口文档

请求参数

Header 参数

appKey

string

AppKey

必需

nonce

string

随机数

必需

timestamp

string

时间戳

必需

signature

string

必需

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

Body 参数application/json

同城热搜榜检索入参【起始和结束时间都不为空才会生效，否则默认当天】

keywords

array[string]

热榜词条表达式

可选

heatIndexRange

object (HeatIndexRange)

可选

热度值范围入参【包头包尾】

fromHeatIndex

integer <int32>

起始热度值【包头】

可选

toHeatIndex

integer <int32>

结束热度值【包尾】

可选

startTime

string <date-time>

可选

起始时间【为空不构建，若startTime、endTime全部为空取当天0点，格式：yyyy-MM-dd HH:mm:ss】

endTime

string <date-time>

可选

结束时间【为空不构建，若startTime、endTime全部为空取当前系统时间，格式：yyyy-MM-dd HH:mm:ss】

sortField

integer <int32>

可选

排序类型【默认热度排序,1-热度、2-采集时间】

>= 1<= 2

默认值:

1

sortWay

string

可选

排序方式【默认倒序,asc-正序、desc-倒序】

默认值:

desc

currentPage

integer <int32>

可选

当前页【默认第一页】

默认值:

1

pageSize

integer <int32>

可选

每页条数【默认每页10条,最大200条】

默认值:

10

type

integer <int32>

可选

渠道类型【默认微博,1-微博、2-抖音、3-百度、4-头条、7-快手】

默认值:

1

city

string

必需

城市【参考：附件说明-不同渠道对应同城热榜信息采集情况说明】，详见《字典接口模块》指定区域父级节点查询城市信息【取返回结果id字段值】

示例

{
  "keywords": [
    "string"
  ],
  "heatIndexRange": {
    "fromHeatIndex": 0,
    "toHeatIndex": 0
  },
  "startTime": "2019-08-24T14:15:22Z",
  "endTime": "2019-08-24T14:15:22Z",
  "sortField": 1,
  "sortWay": "desc",
  "currentPage": 1,
  "pageSize": 10,
  "type": 1,
  "city": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/hotRank/getSearchCityHotRank' \
--header 'appKey;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keywords": [
        "string"
    ],
    "heatIndexRange": {
        "fromHeatIndex": 0,
        "toHeatIndex": 0
    },
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z",
    "sortField": 1,
    "sortWay": "desc",
    "currentPage": 1,
    "pageSize": 10,
    "type": 1,
    "city": "string"
}'

返回响应

🟢200OK

application/json

Body

返回数据格式

code

integer <int32>

可选

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

success

boolean

可选

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

message

string

响应消息

可选

data

object (TableDataVOHotRankCityVO)

可选

数据库分页响应结果集

total

integer <int64>

总记录数

可选

current

integer <int64>

当前页

可选

size

integer <int64>

每页返回条数

可选

records

array[object (HotRankCityVO) {15}]

列表数据

可选

errors

array[string]

错误信息集合

可选

time

string <date-time>

响应时间

可选

示例

{
  "code": 0,
  "success": true,
  "message": "string",
  "data": {
    "total": 0,
    "current": 0,
    "size": 0,
    "records": [
      {
        "title": "string",
        "url": "string",
        "topId": 0,
        "heatIndex": 0,
        "type": 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"
}