Creator Link Performance

GET /api/v1/creators/analytics/links — 🔑 Bearer · Rate limit: 60 req / minute

Returns every bio link that received at least one click in the window, with click count and click-through rate. This endpoint joins across both databases — the click counts come from the Analytics DB (AnalyticsPageView WHERE linkClicked IS NOT NULL), and the link titles/URLs come from the main DB (prisma.bioLink.findMany).

Request

Query parameters

Headers

Response

200 OK — ApiResponseOf<CreatorLinksDto>

{
  "success": true,
  "data": {
    "links": [
      {
        "id": "link-uuid-1",
        "title": "My Portfolio",
        "url": "https://example.com",
        "clicks": 120,
        "ctr": 4.8
      },
      {
        "id": "link-uuid-deleted",
        "title": "Unknown",
        "url": "",
        "clicks": 6,
        "ctr": 0.24
      }
    ],
    "totalViews": 2500
  }
}

Top-level fields

Item fields (links[])

Errors

Same as overview.

Side effects

1. JwtAuthGuard + ThrottleGuard.
2. getBioPageId(userId).
3. Step 1 (Analytics DB) — click counts grouped by link id:

   SELECT "linkClicked" as link_id, COUNT(*)::int as clicks
   FROM "AnalyticsPageView"
   WHERE "bioPageId" = $bioPageId::uuid
     AND "linkClicked" IS NOT NULL
     AND "enteredAt" >= $since
   GROUP BY "linkClicked"
   ORDER BY clicks DESC

4. Step 2 (main DB) — fetch link metadata:
   • prisma.bioLink.findMany({ where: { id: { in: linkIds } }, select: { id, title, url } }).
   • Only runs if Step 1 returned at least one row.
5. Step 3 (Analytics DB) — total views denominator:
   • analyticsDb.analyticsPageView.count({ where: { bioPageId, enteredAt: { gte: since } } }).
6. Step 4 (memory) — stitch the two lists by id. Missing main-DB rows fall back to { title: 'Unknown', url: '' }.
7. Return { links, totalViews }.

Code samples

curl 'https://api.bio.re/api/v1/creators/analytics/links?days=30' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

type LinkPerf = { id: string; title: string; url: string; clicks: number; ctr: number };

async function getLinks(
  accessToken: string,
  days = 30,
): Promise<{ links: LinkPerf[]; totalViews: number }> {
  const res = await fetch(
    `https://api.bio.re/api/v1/creators/analytics/links?days=${days}`,
    { headers: { Authorization: `Bearer ${accessToken}` } },
  );
  const json = await res.json();
  if (!res.ok || !json.success) throw new Error(json?.error?.message ?? 'Failed');
  return json.data;
}

Try it

curl -X GET "https://loading/api/v1/creators/analytics/links"

{
  "success": true,
  "data": {
    "links": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "title": "My Portfolio",
        "url": "https://example.com",
        "clicks": 120,
        "ctr": 4.8
      }
    ],
    "totalViews": 2500
  }
}

{
  "success": false,
  "error": {
    "code": "AUTH_UNAUTHORIZED",
    "message": "Invalid credentials",
    "i18nKey": "auth.login.invalid_credentials",
    "i18nVars": {
      "field": "email"
    },
    "details": [
      {
        "message": "email must be an email"
      }
    ],
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "success": false,
  "error": {
    "code": "AUTH_UNAUTHORIZED",
    "message": "Invalid credentials",
    "i18nKey": "auth.login.invalid_credentials",
    "i18nVars": {
      "field": "email"
    },
    "details": [
      {
        "message": "email must be an email"
      }
    ],
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Source