#The BreakdownDataPoint represents a single dimension breakdown data point object

BreakdownDataPoint represents a single dimension breakdown data point

eventCount

integer (int32)

Number of events for this dimension value

label

string

Dimension label (e.g. browser name, country name, device type)

percentage

number (double)

Percentage of total events

POST/v1/analytics/breakdownRequires auth

#Get dimension breakdown

Returns a ranked breakdown of events by any dimension (browser, platform, device type, country, city, visit type).

#Parameters

This endpoint does not accept any parameters.

#Request body

dimension

string

Dimension to break down by: "browser", "platform", "device_type", "country", "city", "visit_type"

endDate

string (date-time)

Inclusive end timestamp

limit

integer (int32)

Maximum number of results (default 10)

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

Inclusive start timestamp

#Response

200

Everything worked as expected.

data

array<object>

Ordered list of dimension values by event count (descending)

total

integer (int32)

Total number of events in the date range

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/breakdown" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"dimension":"string","endDate":"2026-07-17T21:56:35.747Z","limit":0,"linkId":"string","startDate":"2026-07-17T21:56:35.747Z"}'

Sample payload (application/json)

{
  "dimension": "string",
  "endDate": "2026-07-17T21:56:35.747Z",
  "limit": 0,
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.747Z"
}

Typical response

{
  "data": [
    {
      "eventCount": 0,
      "label": "string",
      "percentage": 0
    }
  ],
  "total": 0
}

Base URL: https://api.linkbreakers.com

POST/v1/analytics/devicesRequires auth

#Get device distribution

Retrieve event distribution across device types.

#Parameters

This endpoint does not accept any parameters.

#Request body

endDate

string (date-time)

Inclusive end timestamp

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

Inclusive start timestamp

#Response

200

Everything worked as expected.

data

array<object>

Device type breakdown

totalEvents

integer (int32)

Total number of events in the date range

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/devices" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"endDate":"2026-07-17T21:56:35.747Z","linkId":"string","startDate":"2026-07-17T21:56:35.747Z"}'

Sample payload (application/json)

{
  "endDate": "2026-07-17T21:56:35.747Z",
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.747Z"
}

Typical response

{
  "data": [
    {
      "deviceType": "string",
      "eventCount": 0,
      "percentage": 0
    }
  ],
  "totalEvents": 0
}

Base URL: https://api.linkbreakers.com

POST/v1/analytics/geoRequires auth

#Get geographic breakdown

Retrieve geographic distribution of events grouped by country or city.

#Parameters

This endpoint does not accept any parameters.

#Request body

endDate

string (date-time)

Inclusive end timestamp

groupBy

string

Group by "country" or "city"

limit

integer (int32)

Maximum number of results (default 10)

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

Inclusive start timestamp

#Response

200

Everything worked as expected.

data

array<object>

Ordered list of locations by event count (descending)

totalEvents

integer (int32)

Total number of events in the date range

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/geo" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"endDate":"2026-07-17T21:56:35.747Z","groupBy":"string","limit":0,"linkId":"string","startDate":"2026-07-17T21:56:35.747Z"}'

Sample payload (application/json)

{
  "endDate": "2026-07-17T21:56:35.747Z",
  "groupBy": "string",
  "limit": 0,
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.747Z"
}

Typical response

{
  "data": [
    {
      "eventCount": 0,
      "location": "string",
      "percentage": 0
    }
  ],
  "totalEvents": 0
}

Base URL: https://api.linkbreakers.com

POST/v1/analytics/hoursRequires auth

#Get hour of day distribution

Retrieve event counts aggregated by hour of day for identifying peak activity times.

#Parameters

This endpoint does not accept any parameters.

#Request body

endDate

string (date-time)

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

#Response

200

Everything worked as expected.

data

array<object>

totalEvents

integer (int32)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/hours" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"endDate":"2026-07-17T21:56:35.748Z","linkId":"string","startDate":"2026-07-17T21:56:35.748Z"}'

Sample payload (application/json)

{
  "endDate": "2026-07-17T21:56:35.748Z",
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.748Z"
}

Typical response

{
  "data": [
    {
      "eventCount": 0,
      "hour": 0
    }
  ],
  "totalEvents": 0
}

Base URL: https://api.linkbreakers.com

POST/v1/analytics/timeseriesRequires auth

#Get grouped time series

Retrieve time-bucketed event counts grouped by a dimension like country, city, device type, or visit type.

#Parameters

This endpoint does not accept any parameters.

#Request body

endDate

string (date-time)

groupBy

string (enum)

GroupByDimension defines the available dimensions for grouping analytics data. Add new dimensions here as the platform grows.

Allowed values

GROUP_BY_DIMENSION_UNSPECIFIED

GROUP_BY_DIMENSION_COUNTRY

GROUP_BY_DIMENSION_CITY

GROUP_BY_DIMENSION_DEVICE_TYPE

GROUP_BY_DIMENSION_VISIT_TYPE

GROUP_BY_DIMENSION_BROWSER

GROUP_BY_DIMENSION_PLATFORM

intervalInMinutes

integer (int32)

limit

integer (int32)

Max number of groups to return (top N by volume). Default 5.

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

#Response

200

Everything worked as expected.

series

array<object>

totalEvents

integer (int32)

Total events across all series

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/timeseries" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"endDate":"2026-07-17T21:56:35.748Z","groupBy":"GROUP_BY_DIMENSION_UNSPECIFIED","intervalInMinutes":0,"limit":0,"linkId":"string","startDate":"2026-07-17T21:56:35.748Z"}'

Sample payload (application/json)

{
  "endDate": "2026-07-17T21:56:35.748Z",
  "groupBy": "GROUP_BY_DIMENSION_UNSPECIFIED",
  "intervalInMinutes": 0,
  "limit": 0,
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.748Z"
}

Typical response

{
  "series": [
    {
      "label": "string",
      "points": [
        {}
      ]
    }
  ],
  "totalEvents": 0
}

Base URL: https://api.linkbreakers.com

POST/v1/analytics/top-linksRequires auth

#Get top performing links

Retrieve links ranked by event count for identifying best performing QR codes and links.

#Parameters

This endpoint does not accept any parameters.

#Request body

endDate

string (date-time)

limit

integer (int32)

Max number of links to return (default 10)

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

#Response

200

Everything worked as expected.

data

array<object>

totalEvents

integer (int32)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/top-links" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"endDate":"2026-07-17T21:56:35.748Z","limit":0,"linkId":"string","startDate":"2026-07-17T21:56:35.748Z"}'

Sample payload (application/json)

{
  "endDate": "2026-07-17T21:56:35.748Z",
  "limit": 0,
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.748Z"
}

Typical response

{
  "data": [
    {
      "eventCount": 0,
      "name": "string",
      "shortlink": "string"
    }
  ],
  "totalEvents": 0
}

Base URL: https://api.linkbreakers.com

POST/v1/analytics/visitorsRequires auth

#Get visitor trends

Retrieve new vs returning visitor counts over time.

#Parameters

This endpoint does not accept any parameters.

#Request body

endDate

string (date-time)

Inclusive end timestamp

intervalInMinutes

integer (int32)

Bucket size in minutes (e.g. 60 for hourly, 1440 for daily)

linkId

string

Optional link filter (UUID); when omitted aggregates workspace-wide

startDate

string (date-time)

Inclusive start timestamp

#Response

200

Everything worked as expected.

data

array<object>

Time-bucketed visitor trend data

totalNew

integer (int32)

Total new visitors in the range

totalReturning

integer (int32)

Total returning visitors in the range

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/analytics/visitors" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"endDate":"2026-07-17T21:56:35.748Z","intervalInMinutes":0,"linkId":"string","startDate":"2026-07-17T21:56:35.748Z"}'

Sample payload (application/json)

{
  "endDate": "2026-07-17T21:56:35.748Z",
  "intervalInMinutes": 0,
  "linkId": "string",
  "startDate": "2026-07-17T21:56:35.748Z"
}

Typical response

{
  "data": [
    {
      "newVisitorCount": 0,
      "returningVisitorCount": 0,
      "timestamp": "2026-07-17T21:56:35.748Z"
    }
  ],
  "totalNew": 0,
  "totalReturning": 0
}

Base URL: https://api.linkbreakers.com

Analytics Data

#The BreakdownDataPoint represents a single dimension breakdown data point object

#Get dimension breakdown

#Parameters

#Request body

#Response

#Error response

#Get device distribution

#Parameters

#Request body

#Response

#Error response

#Get geographic breakdown

#Parameters

#Request body

#Response

#Error response

#Get hour of day distribution

#Parameters

#Request body

#Response

#Error response

#Get grouped time series

#Parameters

#Request body

Allowed values

#Response

#Error response

#Get top performing links

#Parameters

#Request body

#Response

#Error response

#Get visitor trends

#Parameters

#Request body

#Response

#Error response