返回调试台

小红书关键词搜索 API

GET /api/plugins/xiaohongshu/search

接口描述

根据关键词搜索小红书笔记,支持多种排序和筛选方式(如最新、最热、视频/图文、发布时间等)。该接口模拟真实用户搜索行为,需要提供小红书 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 服务器内部错误或搜索过程异常