Your bookmarks, programmable

Full REST API for managing bookmarks from scripts, bots, and automations.

What the API offers

The LinkaGoGo REST API gives you complete programmatic access to your bookmark collection. Everything you can do in the web app, you can do through the API.

  • Full CRUD — create, read, update, and delete bookmarks and folders
  • Search — full-text search with operators like star:4+, folder:Dev, visited:7d
  • Bulk operations — move, tag, rate, favorite, or delete multiple bookmarks at once
  • Import & export — upload Netscape HTML or XBEL files, export your entire collection
  • Folders — create, rename, move, and nest folders to any depth
  • Dead links — retrieve broken and redirected bookmarks flagged by the link checker
  • Stats — get collection statistics: bookmark count, folder count, top tags

Code examples

Search bookmarks

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.linkagogo.com/api/v1/urls?q=python+async&limit=10"

Add a bookmark

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "title": "Example", "keywords": "demo test"}' \
  "https://www.linkagogo.com/api/v1/urls"

List folders

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.linkagogo.com/api/v1/folders"

Move bookmarks to a folder

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": [101, 102, 103], "folder_id": 42}' \
  "https://www.linkagogo.com/api/v1/urls/move"

Authentication

Generate an API key in Account > API Keys within the LinkaGoGo app. Include it as a Bearer token in the Authorization header of every request. API keys never expire but can be revoked at any time.

Rate limits

Plan Daily limit
Plus ($9.99/yr)5,000 requests/day
Premium ($29.99/yr)10,000 requests/day

Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response so your scripts can throttle gracefully.

The Web of Markdown

Every bookmark page in LinkaGoGo — the public pages you share, and your own private views — can also render as plain markdown instead of JSON or HTML. Send Accept: text/markdown to any of them and you get a clean, link-ready document instead: no JSON to parse, no HTML to strip. Perfect for feeding a bookmark collection straight into an LLM's context window, a markdown-native reader, or any other text-based client.

# A public share page — no API key needed
curl -H "Accept: text/markdown" \
  "https://www.linkagogo.com/u/someusername"

# Your own bookmarks, sorted by date added
curl -H "Accept: text/markdown" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.linkagogo.com/app/new"

Want to try it without writing any curl yourself? Mardo is a markdown browser, built by the same author, made for exactly this kind of page.

See the Markdown Views reference for the full list of public and private URLs, including folders, tags, RSS feeds, and your dashboard.

Full documentation

See the complete API reference for all endpoints, request/response schemas, error codes, and pagination details.

Ready to automate your bookmarks?

API access is included with Plus ($9.99/year) and Premium ($29.99/year) plans. Start with a free 7-day trial.

Start Free Trial