小红书搜索 API 文档
函数
from script.search import search_xiaohongshu
data = search_xiaohongshu(keyword, **options)
参数
| 参数 |
类型 |
默认值 |
说明 |
| keyword |
str |
必填 |
搜索关键词 |
| content_type |
str |
"不限" |
内容类型：不限、视频、图文 |
| sort_type |
str |
"综合" |
排序：综合、最新、最多点赞、最多评论 |
| publish_time |
str |
"不限" |
时间：不限、一天内、一周内、半年内 |
| page |
int |
1 |
页码（自动翻页） |
| force |
bool |
False |
强制刷新 |
返回值
{
"search_params": {...}, # 搜索参数
"has_more": True, # 是否有更多
"next_cursor": "...", # 下一页游标
"notes": [...] # 笔记列表
}
笔记字段
| 字段 |
说明 |
| channel_content_id |
笔记ID |
| title |
标题 |
| desc |
摘要 |
| channel_account_name |
作者 |
| like_count |
点赞数 |
| comment_count |
评论数 |
| collect_count |
收藏数 |
| images |
图片列表 |
| link |
链接 |
使用示例
基本搜索
from script.search import search_xiaohongshu
data = search_xiaohongshu("产品测试")
for note in data['notes']:
print(f"{note['title']} - {note['like_count']} 赞")
带参数搜索
data = search_xiaohongshu(
keyword="产品测试",
content_type="视频",
sort_type="最新",
publish_time="一周内"
)
翻页（自动处理）
# 直接指定页码即可
page1 = search_xiaohongshu("产品测试", page=1)
page2 = search_xiaohongshu("产品测试", page=2)
page3 = search_xiaohongshu("产品测试", page=3)
强制刷新
data = search_xiaohongshu("产品测试", force=True)
内部特性
- ✅ 自动重试（最多3次）
- ✅ 自动缓存（默认开启）
- ✅ 自动保存（后台完成）
- ✅ 超时保护（30秒）
