返回博客

小红书关键词搜索笔记 API:选品、热点与竞品监测

Rnote API 团队 · · 158 次阅读 · English
小红书数据 关键词搜索 笔记

关键词搜索是小红书数据采集的核心入口——无论是选品、追热点还是竞品监测,第一步往往都是"按关键词把相关笔记捞出来"。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(搜商品)等端点,详见接口文档

开始使用

免费注册 获取 API Key,查阅文档定价,几分钟即可跑通第一个搜索请求。