Personal API keys

Create API keys in Settings and drive Notebooker from scripts, n8n, or any tool that can send an HTTP request.

Personal API keys let your own scripts and automations talk to Notebooker - save bookmarks from n8n, check whether a URL is already in your library, list notebooks, or kick off podcasts, all without a browser session.

Creating a key

  1. Open Settings in the web app (user menu → Settings).
  2. In the API keys section, click Create API key and give it a name (“n8n automation”, “reading-list script”).
  3. Copy the key immediately - it starts with nbk_ and is shown exactly once. Notebooker stores only a hash of it.

Keys don’t expire on their own; revoke a key from the same section whenever something no longer needs access. The list shows when each key was created and last used.

Using a key

Send the key as a Bearer token:

curl -H "Authorization: Bearer nbk_your_key_here" \
  https://app.notebooker.ai/api/v1/me

The full surface lives in the API reference - every endpoint, parameter, and response schema, with a try-it console. The highlights:

Endpoint What it does
GET /api/v1/me Who am I - verify the key works.
GET /api/v1/account Plan and remaining AI credit for the current period.
GET /api/v1/sources List your saved sources.
POST /api/v1/sources Save a link - body: {"url": "...", "title": "...", "notebook_ids": [...], "generate_quick_podcast": true, "podcast_format": "brief"}. Everything but url is optional.
GET /api/v1/sources/check?url=… Is this URL already saved?
GET /api/v1/notebooks List your notebooks.
GET /api/v1/notebooks/{id}/export/markdown Export a notebook as a zip of Markdown.
GET /api/v1/notes · POST /api/v1/notes List and create notes; GET /api/v1/notes/{id}/download fetches one as Markdown.
POST /api/v1/search Search your sources and notes (text or vector).
POST /api/v1/search/ask Ask a question, get a cited AI answer.
GET /api/v1/podcasts List your podcast episodes.

podcast_format accepts solo_expert, deep_dive, brief, critique, debate, or unabridged - the same format presets as the quick-podcast picker.

Good to know

  • A key acts as you: anything it saves or generates uses your account, your notebooks, and your AI credit.
  • Treat keys like passwords. If one leaks, revoke it - revocation is immediate.
  • Rate limits apply, the same as the browser extension.
  • Prefer no-code? Incoming webhooks can start workflows without any key management, and watched feeds cover the “auto-import this feed” case entirely.