Documentation

Export a link's clicks

GET/v1/links/{link}/clicksAnalytics

Every click and scan of one link in the range, one row each: time, country, referring host, device class and whether it was a QR scan. No IP addresses or user agents are stored, so none are exported. Needs the Pro plan (Free answers 403 forbidden with details.upgrade). A CSV carries the newest 50,000 rows of the range; narrow days for the rest.

Parameters

Parameter	Type	Required	Description
`link`	string, in the path	required	The link's id, or its ending.
`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.
`before`	integer, null	optional	The `next_before` of the previous page.
`format`	json \| csv	optional	`csv` streams every row in the range as text/csv (no paging). Default json.

Example request

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

Example response

{
  "clicks": [
    {
      "ts": "2026-10-19T18:41:03.000Z",
      "code": "spring-menu",
      "country": "US",
      "referrer": null,
      "device": "mobile",
      "via_qr": true
    }
  ],
  "next_before": null
}

With format=csv the answer is text/csv, one row per click, sent as a file download: ts,code,country,referrer,device,via_qr 2026-10-19T18:41:03.000Z,spring-menu,US,,mobile,true

Response fields

Field	Type	Description
`clicks`	ClickRow[]	Newest first, up to 5,000 per page.
`next_before`	integer, null	Pass as `before` for the next page. Null on the last page.

Errors

Status	Meaning
401	The API key is missing, malformed or revoked.
403	The plan does not include this. `details.upgrade` names the plan that does.
404	No link by that id or ending in this account.
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