返回调试台
接口描述
根据关键词搜索小红书笔记,支持多种排序和筛选方式(如最新、最热、视频/图文、发布时间等)。该接口模拟真实用户搜索行为,需要提供小红书 Cookie。
请求参数
| 参数名 |
类型 |
必选 |
描述 |
| keyword |
string |
是 |
搜索关键词 |
| cookie |
string |
是 |
小红书网页版 Cookie(需包含 web_session 等字段) |
| apiKey |
string |
是 |
用户 API Key |
| sort |
integer |
否 |
排序方式:
0 (默认): 综合排序
1: 最新发布
2: 最多点赞
3: 最多评论
4: 最多收藏
|
| noteType |
integer |
否 |
笔记类型:
0 (默认): 全部
1: 视频笔记
2: 图文笔记
|
| publishTime |
integer |
否 |
发布时间:
0 (默认): 不限
1: 一天内
2: 一周内
3: 半年内
|
| number |
integer |
否 |
采集数量:
默认为 20,最大支持 100
|
计费说明
本接口每次调用扣除 5 次用量(点数)。
👉 用量管理:您可以前往 API 插件中心 查看剩余用量及进行充值。
响应参数
| 参数名 |
类型 |
描述 |
| code |
number |
状态码 (0 表示成功) |
| success |
boolean |
请求是否成功 |
| msg |
string |
状态描述信息(含本次消耗详情) |
| data |
array |
笔记列表 |
| data[].note_id |
string |
笔记唯一 ID |
| data[].title |
string |
笔记标题 |
| data[].type |
string |
笔记类型 (normal/video) |
| data[].cover |
string |
封面图片链接 |
| data[].liked_count |
string |
点赞数(可能是数字或"1万+"格式) |
| data[].url |
string |
笔记详情页链接 |
| data[].user |
object |
作者信息 |
| data[].user.user_id |
string |
作者 ID |
| data[].user.nickname |
string |
作者昵称 |
| data[].user.avatar |
string |
作者头像链接 |
| usage |
object |
用量信息 |
| usage.cost |
number |
本次消耗点数 |
示例
请求示例
curl -X GET "https://cyanlis.cn/api/plugins/xiaohongshu/search?keyword=程序员&cookie=...&apiKey=YOUR_API_KEY"
响应示例
Loading...
错误码
| 错误码 |
描述 |
解决方案 |
| 401 |
Unauthorized |
API Key 无效或过期,请检查 Key 是否正确 |
| 400 |
Bad Request |
请求参数错误(如缺少 keyword 或 cookie) |
| 403 |
Forbidden |
余额不足或权限受限 |
| 500 |
Internal Server Error |
服务器内部错误或搜索过程异常 |