Readwise 中文文档 下载 App

Readwise 公开 API：自己动手搭建集成

API 概览

Readwise 的 API 设计简洁，文档完整，返回 JSON 格式数据。主要覆盖：

获取 API Token

  1. 登录 Readwise Web App
  2. 进入 Account → Access Token
  3. 点击 Create New Token
  4. 选择权限范围（只读 / 读写 / 全部）
  5. 复制生成的 Token（只显示一次，丢了就得重新生成）

常用 API 示例

列出所有高亮

GET https://readwise.io/api/v2/highlights/
Authorization: Token YOUR_TOKEN_HERE

返回：

{
  "count": 1234,
  "results": [
    {
      "id": "abc123",
      "text": "复利是世界第八大奇迹。",
      "note": "值得记住",
      "tags": ["productivity", "finance"],
      "book_title": "穷爸爸富爸爸",
      "author": "Robert Kiyosaki",
      "source_url": "https://...",
      "highlighted_at": "2025-08-15T10:30:00Z"
    }
  ]
}

按标签筛选高亮

GET https://readwise.io/api/v2/highlights/?tag=productivity

创建新高亮

POST https://readwise.io/api/v2/highlights/
Content-Type: application/json
Authorization: Token YOUR_TOKEN_HERE

{
  "text": "你唯一能做的，就是做最好的自己。",
  "book_title": "高效能人士的七个习惯",
  "author": "Stephen Covey",
  "tags": ["quote"]
}

用例示例

场景一：定时导出到自己的 Notion 数据库

不想用官方集成？自己写一个简单脚本，定期调用 Readwise API 拉取新高亮，然后通过 Notion API 写进去。可以自定义任何格式和字段。

场景二：把高亮做成 Notion 每日晨间简报

每天早上拉取昨天标记为「重要」的高亮，拼成一个 Markdown 文件推送到 Notion Daily Note。

场景三：做一个个人高亮搜索站

把所有高亮导出成静态网站，像 Readwise 自己的 Library 一样浏览，但用你自己的设计和域名。

场景四：接入你自己的知识图谱

拉取 Readwise 高亮，把它们和你 Zotero 的文献、Obsidian 的笔记关联起来，形成个人知识图谱。

速率限制

Readwise API 有速率限制（具体数值以官方文档为准），日常使用完全足够，但做高频调用需要注意。如果你的集成需求超出了公开 API 的范围，可以联系 Readwise 团队申请更高配额。

和官方导出的关系

官方导出（Notion、Obsidian 等）是 Readwise 帮你搭好的桥，开箱即用。API 给的是地基——你可以自己修桥，想修什么样的就修什么样的。两者互补：