Analytics
Both endpoints need the analytics:read permission and authentication.
| Method | URL | Description |
|---|---|---|
GET | /apiv2/links/{id}/analytics | Click analytics of one link |
GET | /apiv2/analytics | Click analytics of the whole workspace |
Query parameters
| Parameter | Required | Description |
|---|---|---|
from | yes | First day, YYYY-MM-DD. The earliest available day is 2025-01-01 |
to | no | Last day, YYYY-MM-DD. Defaults to today. Must not be before from |
How far back you can read also depends on the click retention of the plan of the workspace owner: an earlier from is moved to the earliest day the plan keeps.
bash
curl "https://api.revolink.link/apiv2/links/LINK_ID/analytics?from=2026-10-01&to=2026-10-31" \
-H "Authorization: Bearer rvlnk_your_api_key_here" \
-H "X-Workspace-Id: your_workspace_id"
The response is { "data": { … } } with click totals and breakdowns for the period (country, region, city, device, browser, OS, referrer, rule and A/B variant). The exact fields are in the interactive reference.
Who can read what
- Analytics of a single link needs access to that link in the workspace.
- Analytics of the whole workspace is available to the workspace owner and to members who can edit any link.