Rnote API Rnote API
返回博客

小红书 API 接入教程：5 分钟用 Python 跑通第一个请求

Rnote API 团队 · · 97 次阅读 · English
小红书数据 API教程 Python

这篇教程带你用 Python 在 5 分钟内跑通第一个小红书（RedNote / Xiaohongshu）数据接口调用。无需自建爬虫、不用维护代理，Rnote API 把采集基础设施都帮你扛好了，你只需要发一个标准 HTTP 请求。

第一步：注册并获取 API Key

前往注册页创建账户并验证邮箱。验证后即可获得免费额度，并在管理后台查看与管理你的 API Key。

第二步：了解请求结构

所有接口都是标准 RESTful 风格：

  • 基础地址：https://rnote.dev/api/v2/crawler
  • 鉴权：在请求头携带 X-API-Key: YOUR_API_KEY
  • 返回：JSON

第三步：发起第一个请求

以"搜索笔记"为例：

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},
    headers=HEADERS,
)
print(resp.status_code)
print(resp.json())

跑通后，你可以把端点换成 note/image（图文详情）、user/info（博主信息）等，参数说明见接口文档。

第四步：处理错误与重试

Rnote API 返回标准 HTTP 状态码。一个稳健的小工具函数：

import time
import requests

def call(path, params, retries=3):
    url = f"https://rnote.dev/api/v2/crawler/{path}"
    headers = {"X-API-Key": "YOUR_API_KEY"}
    for i in range(retries):
        r = requests.get(url, params=params, headers=headers, timeout=30)
        if r.status_code == 200:
            return r.json()
        time.sleep(2 ** i)  # 指数退避
    r.raise_for_status()

好消息是：只有成功请求（HTTP 2xx）才扣费，失败重试不会产生额外费用，因此你可以放心地加重试逻辑。

计费与额度

  • 按请求计费，无月费、无最低消费，用多少付多少。
  • 仅成功请求扣费。
  • 注册即送免费额度，足够完成接口验证与小规模测试。
  • 充值方式与当前优惠见定价页。

下一步

准备好了吗？免费注册，现在就发出你的第一个请求。

返回博客