API 使用文档

快速上手 Rnote API,从注册到发起第一个请求

Base URL

https://rnote.dev/api/v1/crawler

所有 API 端点均以此为前缀,完整的交互式文档可通过 Swagger UI 查看。

在线调试环境

我们提供基于 Apifox 的在线 API 调试环境,输入 API Key 即可直接在浏览器中测试和调用所有接口,无需编写代码。

打开在线调试环境

开始之前

  1. 1 注册账户 并完成邮箱验证
  2. 2 登录 管理后台,在「API Key 管理」中创建一个 API Key
  3. 3 在「计费」页面充值余额(仅成功请求扣费)

认证方式

所有 API 请求需要通过 X-API-Key Header 传递 API Key 进行认证。

# 在 HTTP Header 中传递 API Key
curl -X 'GET' \
  'https://rnote.dev/api/v1/crawler/note/image?note_id=697c0eee000000000a03c308' \
  -H 'accept: application/json' \
  -H 'X-API-Key: sk-5bc4****************************e175'

第一个请求

以获取图文笔记详情为例:

curl -X 'GET' \
  'https://rnote.dev/api/v1/crawler/note/image?note_id=697c0eee000000000a03c308' \
  -H 'accept: application/json' \
  -H 'X-API-Key: sk-5bc4****************************e175'
import requests

API_KEY = "sk-5bc4****************************e175"
BASE_URL = "https://rnote.dev/api/v1/crawler"

response = requests.get(
    f"{BASE_URL}/note/image",
    params={"note_id": "697c0eee000000000a03c308"},
    headers={
        "X-API-Key": API_KEY,
        "accept": "application/json",
    },
)

data = response.json()
print(data)
const API_KEY = "sk-5bc4****************************e175";
const BASE_URL = "https://rnote.dev/api/v1/crawler";

const res = await fetch(
  `${BASE_URL}/note/image?note_id=697c0eee000000000a03c308`,
  {
    headers: {
      "X-API-Key": API_KEY,
      "accept": "application/json",
    },
  }
);

const data = await res.json();
console.log(data);

笔记接口

GET /note/image

获取图文笔记详情,返回笔记内容、图片列表、作者信息、互动数据等

参数: note_id (必填) · domain_type (可选: mainland / overseas)
GET /note/video

获取视频笔记详情,返回视频播放地址、封面图、作者信息等

参数: note_id (必填) · domain_type (可选)
GET /note/mixed

获取首页推荐流笔记详情,留空 note_id 返回推荐流数据

参数: note_id (可选) · domain_type (可选)
GET /note/comments

获取笔记评论列表,支持分页和多种排序方式

参数: note_id (必填) · cursor · index · sort_strategy (default / latest_v2 / like_count)
GET /note/sub_comments

获取笔记二级评论(子评论/回复),游标分页

参数: note_id (必填) · comment_id (必填) · cursor · index · num
POST /note/metrics

上报笔记指标(点赞、收藏、分享等互动数据)

Body: note_id · report_type · target_count

用户接口

GET /user/info

获取用户信息,返回用户昵称、头像、简介、粉丝数等

参数: user_id (必填)
GET /user/posted

获取用户发布的笔记列表,支持游标分页

参数: user_id (必填) · cursor · num
GET /user/faved

获取用户收藏的笔记列表,支持游标分页

参数: user_id (必填) · cursor · num

搜索接口

GET /search/notes

搜索笔记,支持排序和筛选

参数: keyword (必填) · page · sort (general / time_descending / popularity_descending) · note_type (0=全部 / 1=视频 / 2=图文)
GET /search/users

搜索用户

参数: keyword (必填) · page
GET /search/images

搜索图片

参数: keyword (必填) · page
GET /search/products

搜索商品

参数: keyword (必填) · page · sort_by · source
GET /search/groups

搜索群聊

参数: keyword (必填) · page

商品接口

GET /product/detail

获取商品详情

参数: product_id (必填)
GET /product/review/overview

获取商品评论总览

参数: product_id (必填)
GET /product/reviews

获取商品评论列表,支持游标分页

参数: product_id (必填) · cursor · sort_type
GET /product/recommendations

获取商品推荐列表

参数: product_id (必填) · cursor

话题接口

POST /topic/info

获取话题详情

Body: topic_id (必填)
GET /topic/feed

获取话题下的笔记列表,支持游标分页

参数: topic_id (必填) · cursor · sort_by

创作灵感

GET /creator/inspiration/feed

获取推荐灵感列表

参数: cursor · num
GET /creator/hot/inspiration/feed

获取热点灵感列表

参数: cursor · num

响应格式

所有成功响应返回小红书原始 JSON 数据。错误响应使用统一格式:

{
  "detail": "错误描述信息"
}

错误码

HTTP 状态码 说明 处理方式
401 未提供或无效的 API Key 检查 X-API-Key Header
402 余额不足 到管理后台充值余额
403 无权访问该接口 检查 API Key 权限范围
429 请求频率超限 降低请求频率,稍后重试
500 服务器内部错误 稍后重试,持续失败请联系支持
503 无可用设备(账号池耗尽) 稍后重试

计费说明

按请求计费

仅成功请求 (HTTP 2xx) 扣费,失败请求不计费。每个 API 端点独立定价。

余额不足

当余额不足以支付当前请求的费用时,返回 HTTP 402 错误码,请求不会被执行。

交易记录

所有扣费记录可在管理后台「计费」页面查看,包含时间、端点、金额等详情。