Trend object

9 endpoints on 8 platforms return the Trend object with the same 4 fields, so code written for one platform reads the others unchanged. A call costs $0.0020 to $0.0200.

Stable object · Updated 2026-10-17Open in ChatGPTOpen in Claude

A Trend is one entry on a platform's hot list: a search term, a topic or a question, with its rank and the platform's own heat score where the platform gives them. Every platform's hot list comes back as this one object; where a platform has several lists, board picks one.

A trend has no ID on every platform: its name is what identifies it, and it can go as query to a search of the same platform to read what is behind it. On Zhihu an entry's id is its question's.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

The platform's ID for the entry

name text

Name of the entry

rank integer

Position on the board, from 1; a pinned entry has none

heat integer

The platform's heat score

Where each number comes from

The same field name does not always mean the same act on every platform. This table says which of the platform's own numbers goes into the field.

FieldWhat it holds thereOn
heatThe topic index of Douyin's index toolDouyin

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on
idX (Twitter)RedditBilibiliWeibo
rankXiaohongshu (RedNote)
heatX (Twitter)Reddit
One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Trend

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
X trendsGET/v1/x/trends/list$0.0090
Douyin trend-index live hot topicsGET/v1/douyin/index/trends/list$0.0020
Douyin hot search boardGET/v1/douyin/trends/list$0.0020
Xiaohongshu trendsGET/v1/xiaohongshu/trends/list$0.0200
Reddit trending searchesGET/v1/reddit/trends/list$0.0020
Bilibili hot searchesGET/v1/bilibili/trends/list$0.0020
Weibo hot search boardGET/v1/weibo/trends/list$0.0020
Kuaishou hot listGET/v1/kuaishou/trends/list$0.0020
Zhihu hot listGET/v1/zhihu/trends/list$0.0020

Example

One item from x.trends.list, as recorded 2026-10-13 03:29 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Trend · x.trends.list
{ "name": "Weekend hiking", "rank": 1 }

The whole response is on the endpoint's page →

Related

Other objects