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.

GET

uapis.cn

/api/v1/misc/hotboard

Query parameters

type

string

required

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

time

integer

Pro

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

Pro

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

Pro

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

time_end

integer

Pro

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

limit

integer

Pro

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

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.

Note

All returnedupdate_time values are in UTC, formatted as ISO 8601 ending with Z (e.g. 2026-03-20T21:39:16.000Z). Add 8 hours to display Beijing time.

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

{
  "type": "weibo",
  // Hot board update time in UTC (ISO 8601, ending with Z). In time-machine mode this is the returned snapshot's update time.
  "update_time": "2026-03-20T21:39:16.000Z",
  // Actual snapshot timestamp (milliseconds) returned in time-machine mode. Usually omitted for current hot board mode.
  "snapshot_time": 1700000000000,
  // Hot board entries.
  "list": [
    {
      // Additional information. The contents vary by platform; for example, Weibo trending tags such as "new" or "hot".
      "extra": {},
      "hot_value": "1234567",
      "index": 1,
      "title": "What a beautiful day today",
      "url": "https://s.weibo.com/weibo?q=%23%E4%BB%8A%E5%A4%A9%E5%A4%A9%E6%B0%94%E7%9C%9F%E5%A5%BD%23",
      // Cover image URL. Music hot boards return the album cover; most other platforms do not return this field.
      "cover": "https://p1.music.126.net/xxx/109951170483249998.jpg"
    }
  ]
}

Format 2Search mode

JSON

{
  "type": "weibo",
  // Search keyword.
  "keyword": "AI",
  // Number of matched results.
  "count": 0,
  // Search results array.
  "results": [
    {
      "title": "AI breakthrough",
      "hot_value": "999999",
      "url": "https://example.com"
    }
  ]
}

400 / Bad Request

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

JSON

{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Invalid hotboard type specified."
}

500 / Internal Server Error

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

JSON

{
  "code": "INTERNAL_SERVER_ERROR",
  "details": {},
  "message": "Failed to process hotboard data."
}

502 / Bad Gateway

Data is temporarily unavailable. Please try again later.

JSON

{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Failed to fetch hotboard from upstream source."
}

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).

Related APIs

Query Bilibili Video

Want to surface detailed Bilibili video information in your app? Whether it's the cover, title, play count, or creator info — this endpoint returns it all in one call.

Query Weather

Checking the weather before heading out is always a good habit. This endpoint provides accurate, real-time weather data for both domestic and international cities.

Query World Time

Need to schedule a meeting with someone overseas and wonder what time it is there? Use this endpoint for an instant answer.

Extract Webpage Metadata

Want to create link preview cards in your app? This endpoint helps you get webpage title, description, icon and other information in one click.

PreviousCategory overview

NextPhone Number Location Lookup