Documentation

Account analytics

GET/v1/statsAnalytics

Every link in the account summed: totals, by UTC day, the busiest links, and the top countries, referring hosts and devices. Free shows 30 days; Pro shows 365. hours (clicks by hour of the UTC day) is present on Pro. Also available as the MCP tool get_account_stats.

Parameters

Parameter	Type	Required	Description
`days`	integer	optional	How many UTC days back, today included. Free shows 30 days; Pro shows 365. A larger value is capped; `max_days` in the answer says where. Default 30.
`links`	integer	optional	How many of the busiest links to list. Default 10.

Example request

curl -s "https://snip.link/v1/stats?days=30" \
  -H "Authorization: Bearer $SNIP_KEY"

Example response

{
  "days_requested": 30,
  "max_days": 30,
  "total": 412,
  "via_qr": 377,
  "days": [
    {
      "day": "2026-10-18",
      "clicks": 61,
      "scans": 58
    },
    {
      "day": "2026-10-19",
      "clicks": 74,
      "scans": 70
    }
  ],
  "countries": [
    {
      "key": "US",
      "clicks": 390
    },
    {
      "key": "CA",
      "clicks": 14
    }
  ],
  "referrers": [
    {
      "key": "direct",
      "clicks": 401
    },
    {
      "key": "instagram.com",
      "clicks": 11
    }
  ],
  "devices": [
    {
      "key": "mobile",
      "clicks": 388
    },
    {
      "key": "desktop",
      "clicks": 24
    }
  ],
  "links": [
    {
      "id": "lnk_7f0c2a2b4bb04a8b",
      "code": "spring-menu",
      "short_url": "https://snip.link/spring-menu",
      "title": "Spring menu",
      "url": "https://example.com/menus/spring-2026",
      "clicks": 412,
      "scans": 377
    }
  ],
  "links_total": 23
}

Response fields

Field	Type	Description
`days_requested`	integer
`max_days`	integer	The longest range the plan allows.
`total`	integer	Clicks in the range, QR scans included.
`via_qr`	integer	How many of them were QR scans.
`days`	object[]	One row per UTC day with at least one click, oldest first.
`hours`	object[]	Clicks by hour of the UTC day (0 to 23), summed over the range. Plans with time-of-day analytics only.
`countries`	object[]	Top ten ISO country codes.
`referrers`	object[]	Top ten referring hosts; `direct` when there was none.
`devices`	object[]	mobile, tablet or desktop.
`links`	object[]	The busiest links in the range, most clicks first (up to 100).
`links_total`	integer	Links in the account.

Errors

Status	Meaning
401	The API key is missing, malformed or revoked.
429	Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (`details.reason`).

Back to the guide