[中文]

用途:

获取指定笔记的评论列表，支持分页和多种排序方式

⚠️ 计费提示:

如果传入错误或不存在的笔记ID（或分享链接解析失败），接口仍会正常响应，但 data 中会返回上游"服务异常"信息，该请求 同样会正常计费扣费，请在调用前确保参数有效。

参数:

note_id: 笔记ID，如 "697c0eee000000000a03c308"

share_text: 小红书分享链接，支持APP和Web端分享链接，支持 xiaohongshu.com 长链接、xhslink.com 和 xhslink.cn 短链接

优先使用note_id，如果没有则使用share_text，两个参数二选一，如都携带则以note_id为准。

cursor: 分页游标，首次请求留空，翻页时传入上一次响应中返回的 cursor 值

index: 评论索引，首次请求传 0，翻页时传入上一次响应中返回的 index 值

pageArea: 折叠状态，默认 "UNFOLDED"（展开），翻页时传入上一次响应中返回的 pageArea 值

sort_strategy: 排序策略

"latest_v2": 按时间倒序（最新，默认使用）

"like_count": 按点赞数排序（最热）

"default": 默认排序（不推荐，翻页时会丢失评论或重复抓取评论）

评论数据对象，包含评论列表、分页游标等

翻页说明:

首次请求：cursor留空，index传0

翻页请求：传入上一次响应中返回的 cursor 和 index 和 pageArea 值

翻页所需字段通常位于响应的 $.data.data 对象中（如 cursor ← $.data.data.cursor），请从上一次响应中提取对应值传入

[English]

Purpose:

Get comment list for a specified note, supports pagination and multiple sort strategies

⚠️ Billing Notice:

If a wrong or non-existent note ID is passed (or the share link fails to parse), 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:

note_id: Note ID, e.g. "697c0eee000000000a03c308"

share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including xiaohongshu.com full links, xhslink.com and xhslink.cn short links

Prefer to use note_id, if not, use share_text, one of the two parameters is required, if both are carried, note_id shall prevail.

cursor: Pagination cursor, leave empty for first request, pass cursor value from previous response for next page

index: Comment index, pass 0 for first request, pass index value from previous response for next page

pageArea: Fold status, default "UNFOLDED" (unfolded), pass pageArea value from previous response for next page

sort_strategy: Sort strategy

"latest_v2": Sort by time desc (latest, recommended default)

"like_count": Sort by like_count

"default": Sort by default (not recommended, may cause missing or duplicate comments when paginating)

Return:

Comments data object, including comment list, pagination cursor, etc.

Pagination Guide:

First request: leave cursor empty, pass index as 0

Next page: pass cursor and index and pageArea values from previous response

The pagination fields are usually located in the $.data.data object of the response (e.g. cursor ← $.data.data.cursor), extract the corresponding values from the previous response

[示例/Example]

note_id="697c0eee000000000a03c308"
sort_strategy="latest_v2"

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/xiaohongshu/app_v2/get_note_comments?note_id=697c0eee000000000a03c308&share_text=http%3A%2F%2Fxhslink.com%2Fo%2F8GqargIxrko&cursor=&index=0&pageArea=UNFOLDED&sort_strategy=latest_v2' \ --header 'Authorization: Bearer <token>'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取笔记评论列表/Get note comments

[中文]

用途:

⚠️ 计费提示:

参数:

返回:

翻页说明:

[English]

Purpose:

⚠️ Billing Notice:

Parameters:

Return:

[示例/Example]

Request

Responses

获取笔记评论列表/Get note comments

[中文]#

用途:#

⚠️ 计费提示:#

参数:#

返回:#

翻页说明:#

[English]#

Purpose:#

⚠️ Billing Notice:#

Parameters:#

Return:#

Pagination Guide:#

[示例/Example]#

Request

Responses

[中文]

用途:

⚠️ 计费提示:

参数:

返回:

翻页说明:

[English]

Purpose:

⚠️ Billing Notice:

Parameters:

Return:

Pagination Guide:

[示例/Example]