xhs_get_topic_notes_by_topic_url
Read-only
Fetch notes from a Xiaohongshu topic page using a URL, short link, or share text. Sort by hot or time, and paginate with page_token.
Instructions
根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort_type | No | 标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新） | hot |
| topic_url | Yes | 小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。 | |
| page_token | No | 分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 标签页笔记列表 | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| next_page_token | Yes | 下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 | |
| total_note_count | Yes | 标签页笔记总数 | |
| total_user_count | Yes | 标签页涉及用户总数 |