怎么调用 小红书 关键词搜索 API？
search使用 platform="xiaohongshu"、action="search" 调用“关键词搜索”能力；返回列表，每次一页、固定 20 条，更多用 next_page_token 翻页，主要包含 id、url、title、text、like_count、collect_count 等 25 个字段。
这里检索笔记；笔记详情和评论需保留目标链接中的定位信息及 token。
{
"platform": "xiaohongshu",
"action": "search",
"params": {
"keyword": "小户型收纳"
}
}小红书 search 的参数分别是什么意思？
keyword必填- 小红书笔记搜索词，传一个字符串，如 敏感肌防晒；搜索的是笔记内容，不是用户 ID。
content_type可选- 按笔记类型筛选结果，具体类型与取值见当前接口的允许值列表。
小红书公开 Deeplink 文档分别列出图文笔记、视频笔记和笔记评论页。这里只引用内容类型的区别；文档中的 App 跳转参数不能直接传给本接口。官方来源：小红书：图文与视频笔记入口来源核查：
查看全部 3 个允许值
allimagevideo date_range可选- 按笔记发布时间筛选：last_24_hours 最近 24 小时、last_7_days 最近 7 天；不传不限。翻页时保持同一个取值。
查看全部 2 个允许值
last_24_hourslast_7_days page_token可选- 翻页游标（comments、sub_comments、search、user_posts、search_users、hashtag）：把上一次返回结果行里的 next_page_token 原样传入就拿下一页；不传从第一页开始。每页算一次调用，按次计费。
sort可选- search 的笔记列表排序：relevance 相关度、newest 最新、most_liked 点赞最多、most_commented 评论最多、most_collected 收藏最多；只使用当前接口列出的允许值。
查看全部 5 个允许值
most_collectedmost_commentedmost_likednewestrelevance
小红书 返回字段与含义（15）
- like_count
- 点赞数。笔记、评论类结果是这条内容的点赞数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。
- collect_count
- 收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。
- images
- 图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组。null 表示这次没拿到这一项。
- video_url
- 视频播放地址（mp4），带签名、会过期，要留存请及时下载。图文笔记或这次没拿到时为 null。search/user_posts 行与 video 接口返回；note 详情不含（2026-10-14 起要地址请单独调用 video 接口）。
- duration_sec
- 视频时长，单位秒。图文笔记或这次没拿到时为 null。
- is_video
- 是否视频笔记。视频播放地址不在详情返回里（2026-10-14 起）：要地址请用同一篇笔记的 url 单独调用 video 接口，按次计费。
- text
- 笔记正文或评论内容。note、hashtag 返回笔记全文；search、user_posts 返回的笔记正文可能是截断的摘要（分别约 60 字、100 字以内），要全文用笔记 ID 调 note。
- url
- 该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。
- author_url
- 作者主页链接，不带访问令牌，未登录的浏览器打不开；用 author_id 调 profile 返回的 url 可以直接打开。
- author_id
- 作者的用户 ID，可直接传给 profile、user_posts。笔记类结果里是 24 位，与主页链接里的 ID 相同；评论类结果（comments、comments_batch、sub_comments）里多为 29 位的另一种写法。同一个人的两种写法不同，跨批次去重前先用 profile 换成它返回的 user_id。
- next_page_token
- 翻页游标：同一页每行的值相同，原样作为下一次请求的 page_token 就取下一页，其余参数保持不变；为空或没有这个字段表示没有下一页。能传 page_token 的是 search、user_posts、comments、sub_comments、search_users、hashtag；comments_batch 行上也带这一项，但它本身不收 page_token。
- poi_id
- 搜索结果卡片上标的地点 ID（search）；没标地点时没有这个字段。
- poi_name
- 搜索结果卡片上标的地点名称（search）。
- author_is_verified
- 作者是否官方认证（note、search）。
- is_goods_note
- 是否带货笔记（search、user_posts）。