怎么调用 小红书 关键词搜索 API？
search使用 platform="xiaohongshu"、action="search" 调用“关键词搜索”能力；返回列表，每次一页、固定 20 条，更多用 next_page_token 翻页，主要包含 id、url、title、text、like_count、collect_count 等 30 个字段。
这里检索笔记；笔记详情和评论需保留目标链接中的定位信息及 token。
JSON
{ "platform": "xiaohongshu", "action": "search", "params": { "keyword": "小户型收纳" } }
小红书 search 的参数分别是什么意思？
keyword必填- 小红书笔记搜索词，传一个字符串，如 敏感肌防晒；搜索的是笔记内容，不是用户 ID。
content_type可选- 按笔记类型筛选结果，具体类型与取值见当前接口的允许值列表。
小红书公开 Deeplink 文档分别列出图文笔记、视频笔记和笔记评论页。这里只引用内容类型的区别；文档中的 App 跳转参数不能直接传给本接口。官方来源：小红书：图文与视频笔记入口来源核查：
查看全部 3 个允许值
allimagevideo date_range可选- 按笔记发布时间筛选：any_time 不限（不传时同此）、last_24_hours 最近 24 小时、last_7_days 最近 7 天、last_30_days 最近一个月、last_6_months 最近半年、last_1_year 最近一年。last_30_days 和 last_1_year 一页可能不足 20 条，一条都没有的页不收费；想要更满的页请配 sort=newest；这两档只能同步调用。翻页时保持同一个取值。
查看全部 6 个允许值
any_timelast_1_yearlast_24_hourslast_30_dayslast_6_monthslast_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
小红书 返回字段与含义（20）
like_count- 点赞数。笔记、评论类结果是这条内容的点赞数；reviews 是这条商品评价被点「有用」的次数；profile 里是该账号所有笔记累计获得的点赞数。null 表示不公开或这次没拿到，不等于 0。
collect_count- 收藏数。笔记类结果是这篇笔记被收藏的次数；profile 里是该账号笔记累计被收藏的次数。null 表示不公开或这次没拿到，不等于 0。
images- 图片链接列表。note、hashtag、search、user_posts 是笔记的全部图片（按原顺序）；评论类结果（comments、comments_batch、sub_comments）是评论所附的图片，含表情包贴图，没有图片时为空数组；reviews 是买家晒的图，没有晒图时为空数组。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。reviews 是商品评价的全文。
url- 该记录在小红书上的链接。search、note、profile、hashtag 返回的链接一般带访问令牌，未登录的浏览器也能打开（令牌有时效，过期后重新调用即可）；user_posts 返回的笔记链接不带令牌，在浏览器里打开需要令牌：用笔记 ID 调 note 能拿到可以打开的链接；search_users 返回的主页链接同样不带令牌，用 user_id 调 profile 拿能打开的链接。pgy_content_square 不带 keyword 时笔记链接带令牌，带 keyword 时不带（用笔记 ID 调 note 拿能打开的链接）。followers_list 返回的是粉丝的主页链接，同样不带令牌；note_location 返回的笔记链接带上了请求里的令牌（请求里没带就没有）。
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、product_search、pgy_content_square、reviews、followers_list；comments_batch 行上也带这一项，但它本身不收 page_token。
author_red_id- 作者的小红书号：评论类结果（comments、comments_batch、sub_comments）是评论者的，note、search 是笔记作者的。
poi_id- 搜索结果卡片上标的地点 ID（search）；没标地点时没有这个字段。
poi_name- 地点名称：search 是搜索结果卡片上标的地点；note_location 是笔记标的发布地点里「·」后面的那段（如 星巴克(国贸店)）。没标地点或标了多个地点时没有这个字段。
author_is_verified- 作者是否官方认证（note、search）。
is_goods_note- 是否带货笔记（search、user_posts）。
is_cooperation_note- 是否为品牌商业合作笔记（search、note）；拿不到这一项时没有这个字段。
updated_at- 笔记最后编辑时间（search、note；ISO 8601，UTC）；没编辑过时可能与 posted_at 接近或缺省。
video_width- 视频画面宽度（像素，search、video）。
video_height- 视频画面高度（像素，search、video）。