Misc

Query Hotboards

0calls

1 credits / call

Want to keep up with what is trending online? This endpoint pulls real-time hot boards from a wide range of major platforms in one call.

Overview

Provide a platform type and the endpoint returns the current hot board list for that platform. Each entry includes the title, hot value, and original link — ideal for information aggregation apps and dashboards.

Three usage modes

Default mode

Pass only the type parameter to retrieve the current real-time hot board for that platform.

Time-machine mode

Pass type + time to retrieve the nearest displayable historical hot board snapshot around the given timestamp.

Search mode

Pass type + keyword + time_start + time_end to search past hot board entries that contain the keyword within the historical time range. Use limit to cap the number of returned items.

Query parameters

type

stringrequired

The hot board platform you want to query. Pick one from the .

time

integeroptional

Time-machine mode: a millisecond timestamp. Returns the nearest displayable historical hot board snapshot around that time. Omit to get the current real-time hot board.

keyword

stringoptional

Search mode: searches past hot boards for entries containing this keyword within a historical time range. Must be combined with time_start and time_end.

time_start

integeroptional

Required for search mode: search start timestamp (milliseconds), within that platform's historical data coverage.

time_end

integeroptional

Required for search mode: search end timestamp (milliseconds), later than time_start and within that platform's historical data coverage.

limit

integeroptional

Maximum number of results returned in search mode. Default 50, maximum 200.

Name	Type	Attributes	Description
`type`	string	required	The hot board platform you want to query. Pick one from the .
`time`	integer	optional	Time-machine mode: a millisecond timestamp. Returns the nearest displayable historical hot board snapshot around that time. Omit to get the current real-time hot board.
`keyword`	string	optional	Search mode: searches past hot boards for entries containing this keyword within a historical time range. Must be combined with `time_start` and `time_end`.
`time_start`	integer	optional	Required for search mode: search start timestamp (milliseconds), within that platform's historical data coverage.
`time_end`	integer	optional	Required for search mode: search end timestamp (milliseconds), later than time_start and within that platform's historical data coverage.
`limit`	integer	optional	Maximum number of results returned in search mode. Default 50, maximum 200.

Response

200 / OK

Lookup successful. Returns the hot board list for the specified platform. Default mode and time-machine mode return a list array; search mode returns a results array.

Format 1Default mode / Time-machine mode

JSON

Format 2Search mode

JSON

400 / Bad Request

Invalid request parameter. The type you provided is not a supported platform — please double-check the spelling.

JSON

500 / Internal Server Error

Failed to fetch the hot board. The server hit an internal error while processing the data.

JSON

502 / Bad Gateway

Data is temporarily unavailable. Please try again later.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/misc/hotboard?type=weibo'

Frequently asked questions

Which platforms are supported?

Over 40 platforms are supported, including Weibo, Zhihu, bilibili, Douyin, Xiaohongshu, Kuaishou, Toutiao, Baidu, Douban, Hupu, V2EX, Juejin, CSDN and other major social and tech communities.

How often is the hot board data refreshed?

Each call returns the latest available hot board. Different platforms refresh at slightly different rates, but most stay in sync within a few minutes.

What information is included in the response?

Each entry includes the title, hot value, ranking, original link, and update time. Some platforms also include extra labels (e.g. 'New', 'Trending', 'On fire').

Is this API free?

Yes. This API is completely free — no registration or API keys required. You can call it directly.

What is time-machine mode?

Time-machine mode lets you view a hot board snapshot near a past point in time. Pass `time` (millisecond timestamp) and the API returns the nearest displayable historical snapshot. If that platform has no covered historical data for the request, the API reports no historical data or upstream unavailability; it does not pretend the current hot board is the historical result.

How do I search past hot boards?

Use search mode by passing `keyword`, `time_start` (start millisecond timestamp), and `time_end` (end millisecond timestamp). The API searches covered historical hot boards within the range for matching entries. Use `limit` to cap the number of results (default 50, max 200).

PreviousCategory overview

NextPhone Number Location Lookup

Query Hotboards

Overview

Three usage modes

Default mode

Time-machine mode

Search mode

Query parameters

Response

200 / OK

400 / Bad Request

500 / Internal Server Error

502 / Bad Gateway