Weibo-App-API

获取热搜简报/Get hot search brief

Changed on

[中文]

用途:

  • 获取微博热搜简报(今日热点事件纪要),返回当日热点事件的AI摘要, 每个事件包含标题、摘要、热搜战绩(如"TOP1热搜×19"、"热搜霸榜23小时")和来源微博。

参数:

  • 无

返回:

  • 热搜简报数据(微博原始响应),简报内容嵌套在AI智搜卡片中,取值路径为:
    • items[].data.wboxParam.analysis_result: JSON字符串,需先反序列化
    • analysis_result.msg: markdown文本,内含 ```wbCustomBlock 代码块
    • 代码块JSON(type为 hotQuickReport)的 data.event_list: 当日热点事件数组
    • analysis_result.hot_brief_data: JSON字符串,反序列化后 slogan_info 内含简报标题与更新时间

注意:

  • 简报由微博智搜(AI)生成,内容每隔一段时间更新一次,更新时间见 slogan_info.dynamic_wenan
  • 单次返回当日约20条热点事件,该接口不支持翻页
  • 简报内容为多层嵌套的JSON字符串,调用方需要逐层反序列化后才能取到事件列表
  • 简报由AI边生成边返回,命中生成中的响应时服务端会自动重试;极端情况下仍可能返回生成中的响应, 此时 analysis_result 的 chat_status_stage 不为0,msg里只有AI的生成过程而没有简报正文

[English]

Purpose:

  • Get the Weibo hot search brief (daily hot event digest), returning an AI-generated summary of the day's hot events. Each event contains a title, summary, hot search stats (e.g. "TOP1热搜×19", "热搜霸榜23小时") and source posts.

Parameters:

  • None

Return:

  • Hot search brief data (raw Weibo response). The brief is nested inside the AI search card:
    • items[].data.wboxParam.analysis_result: JSON string, needs to be deserialized first
    • analysis_result.msg: markdown text containing a ```wbCustomBlock code block
    • data.event_list of that code block's JSON (its type is "hotQuickReport"): array of the day's hot events
    • analysis_result.hot_brief_data: JSON string; once deserialized, slogan_info holds the brief title and its update time

Note:

  • The brief is generated by Weibo AI search and is refreshed periodically; see slogan_info.dynamic_wenan for the update time
  • Returns about 20 hot events for the current day; this endpoint does not support pagination
  • The brief is a multi-level nested JSON string, callers need to deserialize it level by level
  • The brief is generated progressively by the AI; the server automatically retries when it hits an in-progress response. In rare cases an in-progress response is still returned, in which case analysis_result.chat_status_stage is not 0 and msg only holds the AI generation trace

[示例/Example]

无需参数 / No parameters required

get/api/v1/weibo/app/fetch_hot_search_brief

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes