Version: v0.31.0
Version: 1.0.0
Karakeep API
Karakeep is a self-hostable bookmarking and read-it-later service. This API allows you to manage bookmarks, lists, tags, highlights, assets, and backups programmatically.
Authentication
All endpoints require a Bearer token passed in the Authorization header. You can generate an API key from the Karakeep web UI under Settings > API Keys.
Pagination
List endpoints support cursor-based pagination via cursor and limit query parameters. The response includes a nextCursor field — pass it as the cursor parameter to fetch the next page. A null value for nextCursor indicates there are no more results.
Bookmarks can be one of three types:
- link — A URL bookmark with optional crawled metadata.
- text — A plain text note.
- asset — An uploaded file (image or PDF).
Authentication
| Security Scheme Type: | http |
|---|---|
| HTTP Authorization Scheme: | bearer |
| Bearer format: | JWT |