返回调试台
接口描述
批量采集指定小红书用户发布的所有笔记列表。支持输入用户主页链接或包含链接的分享文本。接口会自动处理分页滚动，直至达到指定数量或采集完所有笔记。
请求参数
| 参数名 |
类型 |
必选 |
描述 |
| url |
string |
是 |
用户主页链接，或包含链接的分享文本（如“@用户...查看Ta的主页>> http...”） |
| cookie |
string |
是 |
小红书网页版 Cookie，需包含 web_session 等关键字段 |
| apiKey |
string |
是 |
用户 API Key |
| number |
number |
否 |
采集数量。默认 20。输入 0 代表采集该用户全部笔记。 |
计费说明
本接口每次调用扣除 5 次用量。
👉 用量管理：您可以前往 API 插件中心 查看剩余用量及进行充值。
响应参数
| 参数名 |
类型 |
描述 |
| code |
number |
状态码，0 表示成功 |
| success |
boolean |
请求是否成功 |
| msg |
string |
提示信息（包含本次消耗及剩余用量） |
| data |
array |
笔记列表 |
| └─ note_id |
string |
笔记唯一标识 ID |
| └─ title |
string |
笔记标题 |
| └─ type |
string |
笔记类型（video: 视频, normal: 图文） |
| └─ cover |
string |
封面图片链接 |
| └─ liked_count |
string |
点赞数量 |
| └─ url |
string |
笔记详情页链接（含追踪参数） |
| usage |
object |
消耗详情 |
| └─ cost |
number |
本次调用消耗点数 |
示例
请求示例
curl -X GET "https://cyanlis.cn/api/plugins/xiaohongshu/user_notes?url=https://www.xiaohongshu.com/user/profile/5c3be58600000000070106b0&apiKey=YOUR_API_KEY"
响应示例
Loading...
错误码
| 错误码 |
描述 |
解决方案 |
| 401 |
Unauthorized |
API Key 无效或过期，请检查 Key 是否正确 |
| 400 |
Bad Request |
请求参数错误（如 URL 为空） |
| 403 |
Forbidden |
余额不足或权限受限 |
| 500 |
Internal Server Error |
服务器内部错误或采集失败 |