Topic object

The Topic object has 6 fields and is returned by 1 endpoint on Xiaohongshu (RedNote). A call costs $0.0200. It is a preview structure and may still change.

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

A Topic is the page that gathers the posts made under one hashtag or subject, with its name, its description and how often it was viewed. It comes from the topic pages of Xiaohongshu (RedNote), which add the discussion count the page shows in ext.discussions.

Its id, the topic page ID of 24 hexadecimal characters, goes unchanged to the endpoint that lists the trending notes under it, which come back as Post. A Trend on a hot list is something else: an entry of a board, identified by its name.

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

ID; pass it unchanged to the endpoints that get the topic and list the posts under it

name text

Name of the topic

url link

Link that opens the topic

description text

What the topic says it is about; null when it says nothing

metrics object

Topic counts

metrics.views integer

Views of the topic

metrics.posts integer

Posts under the topic

What a platform cannot give

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

FieldNot available on
metrics.postsXiaohongshu (RedNote)
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 Topic

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

EndpointPathPrice
Xiaohongshu topic detailGET/v1/xiaohongshu/topics/get$0.0200

Example

One item from xiaohongshu.topics.get, as recorded 2026-10-13 03:28 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Topic · xiaohongshu.topics.get
{
  "id": "6ba8911100000000e0fbcdfc",
  "name": "周末露营装备推荐",
  "url": "https://www.xiaohongshu.com/page/topics/6ba8911100000000e0fbcdfc",
  "description": null,
  "metrics": { "views": 8553318142 }
}

The whole response is on the endpoint's page →

Related

Other objects