Analytics API

Get click statistics, geographic data, and referrer information for your links.

GET/api/v1/stats/:code

Get detailed click statistics for a link by its short code.

Scope: analytics:read

Request

curl https://trimlink.co/api/v1/stats/my-link \
  -H "Authorization: Bearer tk_live_your_api_key"

Response

200Response

{
  "success": true,
  "data": {
    "totalClicks": 1542,
    "uniqueClicks": 1203,
    "clicksByDay": [
      { "date": "2026-01-30", "clicks": 45 },
      { "date": "2026-01-29", "clicks": 62 },
      { "date": "2026-01-28", "clicks": 38 }
    ],
    "topCountries": [
      { "country": "US", "clicks": 523 },
      { "country": "GB", "clicks": 234 },
      { "country": "DE", "clicks": 156 }
    ],
    "topReferrers": [
      { "referrer": "twitter.com", "clicks": 312 },
      { "referrer": "direct", "clicks": 456 },
      { "referrer": "google.com", "clicks": 189 }
    ],
    "devices": {
      "mobile": 823,
      "desktop": 612,
      "tablet": 107
    },
    "browsers": {
      "Chrome": 892,
      "Safari": 423,
      "Firefox": 227
    }
  }
}

Response Fields

Field	Type	Description
`totalClicks`	number	Total click count
`uniqueClicks`	number	Unique visitors
`clicksByDay`	array	Daily click breakdown
`topCountries`	array	Top countries by clicks
`topReferrers`	array	Top referrer sources
`devices`	object	Device type breakdown
`browsers`	object	Browser breakdown

Plan Requirements

Analytics data retention varies by plan:

Growth: 30 days of detailed analytics
Teams: 90 days of detailed analytics
Enterprise: Unlimited retention