API 使用文档

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

开始之前

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/v2/crawler/note/image?note_id=697c0eee000000000a03c308' \
  -H 'accept: application/json' \
  -H 'X-API-Key: sk-5bc4****************************e175'

第一个请求

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

curl -X 'GET' \
  'https://rnote.dev/api/v2/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/v2/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/v2/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);

用同一把 API Key 查自己的账号数据，不必登录后台 —— 适合在脚本里做成本核算与余额告警。

curl 'https://rnote.dev/api/v1/account/balance' \
  -H 'X-API-Key: sk-5bc4****************************e175'

余额与消费

我的价格

账号信息

当前 Key

小红书站内的公开内容数据：笔记、用户、搜索、商品、话题、创作灵感。多为 GET 请求，参数走 query string。

笔记接口

用户接口

搜索接口

商品接口

话题接口

创作灵感

小红书蒲公英（创作者商业合作平台）的商业数据：博主选号与报价、粉丝画像、笔记转化率、内容广场榜单、关键词搜索指数——做达人投放与竞品分析的关键数据。

curl -X 'POST' \
  'https://rnote.dev/api/v2/pgy/blogger/notes-rate' \
  -H 'X-API-Key: sk-5bc4****************************e175' \
  -H 'Content-Type: application/json' \
  -d '{"user_id": "5c668b3e0000000012021605", "note_type": 3, "date_type": 1}'

博主基础数据

按博主 ID 取商业档案与受众数据，投放前评估用。

笔记案例

博主发过的笔记明细。两个接口字段结构不同，不可混用。

博主发现 / 选号

从全站找候选博主，而不是已知 ID 查详情。

笔记维度

按笔记 ID 取商业数据。

内容广场

跨博主的热门内容榜单，用于找选题、看爆款。

关键词分析

看某个词的搜索热度与人群，用于选题和投放定向。

参数枚举取值（如 note_type / order_type / date_type / biz_type）与完整返回字段详见 Swagger UI，或读蒲公英数据 API 介绍。

响应格式

所有数据接口（/api/v2/crawler/*、/api/v2/pgy/*）使用统一的 JSON 响应结构：

成功响应

{
  "success": true,
  "data": { /* 业务数据，结构因接口而异 */ },
  "billed": true,
  "debug_id": "a1b2c3d4",
  "debug_info": "..."   /* 诊断信息，反馈问题时附上即可 */
}

失败响应

{
  "success": false,
  "data": null,
  "error": "请求过于频繁，请稍后重试",
  "retry_after": 5.0,
  "billed": false,
  "debug_id": "a1b2c3d4",
  "debug_info": "..."   /* 诊断信息，反馈问题时附上即可 */
}

字段说明

错误码

中间件层（鉴权 / 限流 / 计费）

这些状态码在请求到达业务逻辑前就会返回，与具体接口无关。

业务接口层（数据接口）

数据接口失败响应使用标准 4xx/5xx 状态码 + Retry-After 头。请同时检查 HTTP 状态码和 body.success。

客户端错误处理示例

推荐写法 —— 同时检查 HTTP 状态码和 body.success，并在异常日志里附上 debug_id：

import requests

resp = requests.get(
    "https://rnote.dev/api/v2/crawler/user/info",
    headers={"X-API-Key": "sk-..."},
    params={"user_id": "..."},
    timeout=20,
)
body = resp.json()

# 双重判断: HTTP status 优先, body.success 兜底
if resp.status_code >= 400 or not body.get("success"):
    error = body.get("error", "未知错误")
    debug_id = body.get("debug_id", "n/a")
    retry_after = body.get("retry_after")
    print(f"请求失败 [{debug_id}]: {error}", end="")
    if retry_after:
        print(f" (建议 {retry_after}s 后重试)")
    # 联系支持时附上 debug_id
else:
    data = body["data"]
    # 处理业务数据 ...

计费说明

私有化部署

本页所有接口都由托管服务提供，按次计费。如果调用量大、或者数据不能经过第三方，也可以买下服务端源码部署在自己的机器上。