API 使用文档
快速上手 Rnote API,从注册到发起第一个请求
开始之前
认证方式
所有 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 错误码,请求不会被执行。
交易记录
所有扣费记录可在管理后台「计费」页面查看,包含时间、端点、金额等详情。