API

Analytics API

Retrieve Qorlivo click analytics, unique visitors, timeseries data, countries, devices, browsers, and referrers.

Use the Analytics API to build reports, sync campaign metrics, or power company dashboards.

Get analytics

GET /api/v1/analytics?linkId={linkId}&start=2026-07-01&end=2026-07-31

Query parameters:

Parameter	Type	Required	Notes
`linkId`	string	No	Restrict analytics to one link. Omit for workspace-level data.
`start`	string	No	ISO 8601 date. Defaults to 7 days before `end`.
`end`	string	No	ISO 8601 date. Defaults to today.

The maximum date range is 90 days.

Example:

curl "https://www.qorlivo.com/api/v1/analytics?start=2026-07-01&end=2026-07-31" \
  -H "Authorization: Bearer $QORLIVO_API_KEY"

Response:

{
  "totalClicks": 1200,
  "totalUnique": 940,
  "timeseries": [
    {
      "day": "2026-07-01",
      "clicks": 82,
      "uniqueClicks": 71
    }
  ],
  "countries": {
    "US": 780,
    "CA": 120
  },
  "devices": {
    "mobile": 820,
    "desktop": 340,
    "tablet": 40
  },
  "browsers": {
    "Chrome": 650,
    "Safari": 410
  },
  "referrers": {
    "twitter.com": 240,
    "newsletter.example.com": 180
  }
}

Link-specific report

Use linkId when you want analytics for one short link.

curl "https://www.qorlivo.com/api/v1/analytics?linkId=j97xxxxxxxxxxxxxxxxxxxxxxxxx&start=2026-07-01&end=2026-07-07" \
  -H "Authorization: Bearer $QORLIVO_API_KEY"

Reading the response

Field	Meaning
`totalClicks`	Total clicks in the range.
`totalUnique`	Approximate unique visitors in the range.
`timeseries`	Daily click and unique visitor counts.
`countries`	Click counts grouped by country code.
`devices`	Click counts grouped by device category.
`browsers`	Click counts grouped by browser.
`referrers`	Click counts grouped by referrer.

Date handling

Use ISO 8601 date strings:

2026-07-01
2026-07-01T00:00:00.000Z

If start or end is invalid, Qorlivo returns 400.

Reporting tips

Store the date range you used so reports are repeatable.
Compare links over the same window.
Expect some referrers to appear as direct or unknown.
Use link-specific analytics for campaign decisions.
Use workspace-level analytics for overall reporting.