Detect traffic anomalies (spikes/drops) for a link

GET

/api/v1/links/{code}/analytics/anomalies

const url = 'https://example.com/api/v1/links/example/analytics/anomalies?lookback_days=60&threshold=3';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://example.com/api/v1/links/example/analytics/anomalies?lookback_days=60&threshold=3' \
  --header 'Authorization: Bearer <token>'

Authorizations

bearer

Parameters

Path Parameters

code

required

string

Short code or custom alias

Query Parameters

lookback_days

number

default: 60 >= 14 <= 365

Number of days to look back for anomaly detection

threshold

number

default: 3

Z-score threshold for anomaly detection

Responses

200

application/json

object

shortCode

required

string

lookbackDays

required

number

threshold

required

number

anomalies

required

Array<object>

object

date

required

string

type

required

string

Allowed values: spike drop

value

required

Actual click count on this day

number

baselineMean

required

Rolling mean baseline

number

baselineStddev

required

Rolling standard deviation

number

zScore

required

Z-score of the anomaly

number

severity

required

string

Allowed values: low medium high

Example

{
  "anomalies": [
    {
      "date": "2026-02-15",
      "type": "spike",
      "severity": "low"
    }
  ]
}

403

Forbidden — not the owner

404

Link not found