http://plugin.aiconductor.fun/api/xhs_note_comments_fastPOST / GETapplication/jsonAuthorization: Bearer <api_key>(兼容 body/query 中 api_key 参数)| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| note_id | string | 否 | None | 笔记 ID(share_text 为空时必填),优先使用 |
| share_text | string | 否 | None | 分享链接,支持 xiaohongshu.com 长链 |
| max_pages | int | 否 | 1 | 最大翻页数,非法值(≤0 或非数字)回退为 1 |
| max_seconds | int | 否 | 50 | 最长运行时长(秒),非法值回退为 50,上限 170(平台对插件有 180 秒硬超时) |
鉴权参数:api_key 通过请求头 Authorization: Bearer <api_key>传递,不列入请求参数表。note_id与share_text至少提供一个,否则直接返回参数错误且不产生扣费。
| 参数名 | 类型 | 说明 |
|---|---|---|
| success | boolean | 是否成功 |
| message | string | 响应消息;停止翻页时附带具体原因(余额不足 / 上游错误 / 无更多数据) |
| billing | object | 计费信息(service_fee / discount_applied / balance_before / balance_after / currency / pages_billed / total_service_fee / transaction_ids) |
| data.code | int | 上游返回码(0 为正常) |
| data.user_id | string | 笔记所属用户 ID |
| data.comments | array[object] | 一级评论列表(多页合并、按时间倒序;字段见下) |
| data.cursor | string | 末页返回的上游翻页游标(JSON 字符串,形如 {"cursor":"...","index":2,"pageArea":"ALL"}) |
| data.has_more | boolean | 达到 max_pages 且仍有更多数据时为 true |
| data.time | int | 处理完成时间戳(毫秒) |
| data.total_pages | int | 实际抓取页数 |
| data.total_comments | int | 评论总数(各页累计) |
data.comments[] 主要字段(上游 App 端评论结构):| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 评论 ID |
| note_id | string | 所属笔记 ID |
| content | string | 评论内容 |
| like_count | int | 点赞数 |
| sub_comment_count | int | 子评论总数 |
| sub_comments | array[object] | 上游内联返回的部分子评论(同下过滤规则);完整子评论需另行调用上游 get_note_sub_comments,本接口不展开 |
| time | int | 评论时间(秒级 Unix 时间戳) |
| user | object | 评论者信息:userid、nickname、original_name、images(头像)、red_id、level、ai_agent |
| comment_type | int | 评论类型 |