# Xiaohongshu topic feed

Get notes list under a specified topic, supports sorting by trending or latest, using cursor pagination. Needs page id. Served by TikHub.

Purpose:
- Get notes list under a specified topic, supports sorting by trending or latest, using cursor pagination
⚠️ Billing Notice:
- If a wrong or non-existent topic page ID is passed, the endpoint still responds normally, but the `data` field will contain an upstream "service error" message. Such requests **will still be billed as normal**. Please make sure the parameters are valid before calling.
Parameters:
- page_id: Topic page ID (required), e.g. "5c1cc866febed9000184b7c1"
    - Can be obtained from single note API or search API
- sort: Sort type
    - "trend": Trending (default)
    - "time": Latest
- cursor_score: Pagination cursor score, pass last item's cursor_score from previous response
- last_note_id: Last note ID from previous page
- last_note_ct: Last note create time from previous page
- session_id: Session ID, keep consistent for pagination
- first_load_time: First load timestamp, keep consistent for pagination
- source: Source, default "normal"
Return:
- Topic notes list data
Pagination Guide:
- First request: only pass page_id and sort, leave others empty
- Next page: pass fields from last item of previous response:
    - cursor_score ← items[-1].cursor_score
    - last_note_id ← items[-1].id
    - last_note_ct ← items[-1].create_time
- Recommended to also pass session_id and first_load_time for session consistency

- Tool ID: `tikhub/xiaohongshu-app-v2-get-topic-feed`
- Name in the catalog: Xiaohongshu, Get topic feed
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Xiaohongshu trends & hot lists](/tools/xiaohongshu/trends.md)
- Price: $0.01 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.01
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.01; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "description": "话题页面ID/Topic page ID",
      "title": "Page Id"
    },
    "sort": {
      "type": "string",
      "description": "排序方式/Sort: trend(最热), time(最新)",
      "default": "trend",
      "title": "Sort"
    },
    "cursor_score": {
      "type": "string",
      "description": "分页游标分数，翻页时传入/Pagination cursor score for next page",
      "default": "",
      "title": "Cursor Score"
    },
    "last_note_id": {
      "type": "string",
      "description": "上一页最后一条笔记ID，翻页时传入/Last note ID from previous page",
      "default": "",
      "title": "Last Note Id"
    },
    "last_note_ct": {
      "type": "string",
      "description": "上一页最后一条笔记创建时间，翻页时传入/Last note create time from previous page",
      "default": "",
      "title": "Last Note Ct"
    },
    "session_id": {
      "type": "string",
      "description": "会话ID，翻页时保持一致/Session ID, keep consistent for pagination",
      "default": "",
      "title": "Session Id"
    },
    "first_load_time": {
      "type": "string",
      "description": "首次加载时间戳，翻页时保持一致/First load timestamp, keep consistent for pagination",
      "default": "",
      "title": "First Load Time"
    },
    "source": {
      "type": "string",
      "description": "来源/Source",
      "default": "normal",
      "title": "Source"
    }
  },
  "required": [
    "page_id"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/xiaohongshu-app-v2-get-topic-feed",
  "input": {
    "page_id": "5c1cc866febed9000184b7c1",
    "sort": "trend",
    "cursor_score": "",
    "last_note_id": "",
    "last_note_ct": "",
    "session_id": "",
    "first_load_time": "",
    "source": "normal"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Xiaohongshu-App-V2-API/get_topic_feed_api_v1_xiaohongshu_app_v2_get_topic_feed_get)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/xiaohongshu-app-v2-get-topic-feed) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/xiaohongshu-app-v2-get-topic-feed) · [Agent index](/llms.txt)