小红书关键词搜索笔记 API:选品、热点与竞品监测
小红书数据
关键词搜索
笔记
关键词搜索是小红书数据采集的核心入口——无论是选品、追热点还是竞品监测,第一步往往都是"按关键词把相关笔记捞出来"。Rnote API 的搜索接口让你用一个关键词,就能批量、分页地获取相关笔记列表,并支持按综合、最新、最多点赞等多种方式排序。
关键词搜索能做什么?
- 选品与趋势发现:搜索品类关键词(如"露营装备""平价彩妆"),按点赞数排序,快速定位当下热门笔记与卖点。
- 竞品监测:搜索品牌名或产品名,追踪相关笔记的数量与互动变化,感知市场声量。
- 内容选题:分析某话题下的爆款笔记标题与结构,指导自有账号创作。
- 舆情追踪:定期搜索品牌关键词,及时发现负面或风险内容。
接口说明
GET /api/v2/crawler/search/notes
常用查询参数:
| 参数 | 说明 |
|---|---|
keyword |
搜索关键词(必填),如 美食推荐 |
page |
页码,从 1 开始 |
sort_type |
排序:general(综合) / time_descending(最新) / popularity_descending(最多点赞) / comment_descending(最多评论) / collect_descending(最多收藏) |
note_type |
笔记类型:不限 / 视频笔记 / 普通笔记 / 直播笔记 |
time_filter |
发布时间:不限 / 一天内 / 一周内 / 半年内 |
Python 调用示例
import requests
API_BASE = "https://rnote.dev/api/v2/crawler"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}
resp = requests.get(
f"{API_BASE}/search/notes",
params={
"keyword": "露营装备",
"page": 1,
"sort_type": "popularity_descending", # 按点赞数排序
"time_filter": "一周内",
},
headers=HEADERS,
)
results = resp.json()
# 遍历结果,拿到每条笔记的 note_id,再调图文/视频接口取详情
拿到 note_id 后,可进一步调用无水印图文/视频接口获取笔记完整内容。
分页与去重建议
- 翻页时,把首次搜索返回的
search_id/search_session_id传入后续请求,以保证翻页连续性。 - 跨页采集时按
note_id去重,避免不同排序下的重复笔记。 - 仅成功请求扣费,因此你可以放心地对失败请求做重试,不会产生额外费用。
常见问题
Q:搜索结果能拿多少页?
A:可通过 page 持续翻页,建议结合 time_filter 与排序方式聚焦你真正关心的区间,既省额度又更精准。
Q:能搜博主和商品吗?
A:可以。除 search/notes 外,还提供 search/users(搜博主)、search/products(搜商品)等端点,详见接口文档。