Quickstart

1. Create a key

Keys live on your account. Make one here — it works the moment it appears, and you can revoke it just as fast.

Keep it out of your shell history and out of any repository. Everything below assumes it is in an environment variable:

export WEBBITES_KEY="wb_live_…"

2. Make your first call

GET /bookmarks returns your most recent saves. If this answers with JSON, everything else on this site will work too.

curl https://api.webbites.io/v1/api/bookmarks?limit=5 \
  -H "Authorization: Bearer $WEBBITES_KEY"

You get back an array and a cursor:

{
  "bookmarks": [
    {
      "id": "abc123",
      "url": "https://example.com",
      "title": "Example",
      "type": "website",
      "tags": ["docs"],
      "createdAt": "2026-01-02T10:00:00.000Z"
    }
  ],
  "nextBefore": "2026-01-02T10:00:00.000Z"
}

3. Save something

POST /bookmarks needs a url and takes optional tags and a note. It answers immediately, before the page has been fetched.

curl -X POST https://api.webbites.io/v1/api/bookmarks \
  -H "Authorization: Bearer $WEBBITES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://nuxt.com","tags":["reading","vue"],"note":"For the docs rewrite"}'

{
  "id": "abc123",
  "url": "https://nuxt.com",
  "status": "processing"
}

4. Where to go next

• Searching & paging — filters, full-text search and walking the whole library.
• Webhooks — get pushed the finished bookmark instead of polling for it.
• Recipes — a backup script, a Slack command and a digest you can copy whole.
• Playground — try any endpoint from the browser.