Short Link Stats

Endpoints

GET /api/v1/analytics/short-links-summary?from=&to=&campaign=
GET /api/v1/short-links/:slug/stats                                  per-link drill-down

The summary endpoint returns the workspace-level rollup; the per-link endpoint returns the click time series for one short URL.

What's logged per click

Each redirect logs a click record:

{
  short_link_id: ObjectId,
  ts: Date,
  country: string | null,    // IP-derived
  referrer: string | null,
  device: "mobile" | "tablet" | "desktop" | "bot" | "unknown",
  user_agent_hash: string,   // hashed; raw UA not retained
}

Country is derived from the requester's IP at redirect time; raw IPs are not stored.

Aggregations

The summary view aggregates by:

• Total clicks.
• Top short links by click count.
• Top countries.
• Top referrers (Twitter, Instagram, direct, email, etc.).
• Device breakdown.

Filters: from / to (ISO-8601, default 30 days), campaign (single campaign ID).

Related

Short Links Overview

Click Tracking

Campaign Performance