List links

Returns all your links, newest first, with folder info and associated tags.

Example request

curl "https://rynqu.com/api/bookmarks" \
  -H "Authorization: Bearer sk_xxxx"

Response — 200 OK

A JSON array of bookmark objects. Each object includes the folder (folder) and tags (bookmarkTags) if they exist.

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://example.com/article",
    "title": "Example Domain",
    "description": "This domain is for use in illustrative examples.",
    "summary": "Un résumé généré par l'IA une fois le traitement terminé.",
    "imageUrl": "https://cdn.useblink.app/og/550e8400.jpg",
    "faviconUrl": "https://cdn.useblink.app/favicon/example.com.png",
    "screenshotUrl": "https://cdn.useblink.app/screenshots/550e8400.jpg",
    "type": "article",
    "status": "ready",
    "folderId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "isFavorite": false,
    "createdAt": "2026-05-06T12:00:00.000Z",
    "updatedAt": "2026-05-06T12:05:00.000Z",
    "folder": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Développement",
      "icon": "💻",
      "color": "#6366f1"
    },
    "bookmarkTags": [
      {
        "tag": {
          "id": "t1-uuid-...",
          "name": "javascript",
          "color": "#6366f1"
        }
      }
    ]
  }
]

Notable fields

Field	Values	Notes
status	pending · processing · ready	Changes as AI processing progresses.
type	article · video · tool · repo · null	Automatically classified by the AI.
summary	string · null	AI-generated summary — null if not yet processed.
screenshotUrl	url · null	Available once the status is ready.
bookmarkTags	array	Tags attached to the link with color.

Possible errors

401UNAUTHORIZEDAPI key missing or invalid.

429RATE_LIMIT_EXCEEDEDRequest quota exceeded.

Create a link Delete

Was this page helpful?