Estadísticas

Las vistas de una página y los clics de un enlace corto, en el periodo que elijas, con su reparto por procedencia, país y dispositivo.

Clics de un enlace corto

GET/v1/links/{id}/stats

?days= vale 1, 7, 30 (por defecto), 90, o 0 para desde siempre. Ámbito Lectura.

total: el total del periodo; previous_total, el del periodo anterior, y change_pct, la variación en porcentaje
all_time_total: el total desde la creación
daily: la serie por día; con ?days=0 se sustituye por monthly, una entrada por mes (month, count)
referrers: la procedencia; un nombre de dominio, direct o unknown
countries: el código del país en dos letras, o unknown
devices: desktop, mobile, tablet, console, tv o unknown

curl "https://api.tinylink.fr/v1/links/promo/stats?days=7" \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/links/promo/stats?days=7', {
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/links/promo/stats?days=7');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    'https://api.tinylink.fr/v1/links/promo/stats?days=7',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "metric": "clicks",
  "days": 7,
  "from": "2026-09-29",
  "to": "2026-10-05",
  "total": 42,
  "previous_total": 35,
  "change_pct": 20.0,
  "all_time_total": 318,
  "daily": [
    {
      "date": "2026-09-29",
      "count": 4
    },
    {
      "date": "2026-09-30",
      "count": 9
    },
    {
      "date": "2026-10-01",
      "count": 6
    },
    {
      "date": "2026-10-02",
      "count": 3
    },
    {
      "date": "2026-10-03",
      "count": 8
    },
    {
      "date": "2026-10-04",
      "count": 7
    },
    {
      "date": "2026-10-05",
      "count": 5
    }
  ],
  "referrers": [
    {
      "source": "instagram.com",
      "count": 25
    },
    {
      "source": "direct",
      "count": 17
    }
  ],
  "countries": [
    {
      "country": "FR",
      "count": 36
    },
    {
      "country": "BE",
      "count": 6
    }
  ],
  "devices": [
    {
      "device": "mobile",
      "count": 31
    },
    {
      "device": "desktop",
      "count": 11
    }
  ]
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Lectura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"read\" scope.",
    "details": {
      "required_scope": "read"
    }
  }
}

Ningún enlace corto con este identificador o este slug en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Link not found in this environment."
  }
}

Periodo no ofrecido

{
  "error": {
    "code": "validation_failed",
    "message": "The \"days\" parameter must be one of: 1, 7, 30, 90, 0 (all time).",
    "details": {
      "field": "days"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Vistas de una página

GET/v1/pages/{id}/stats

Mismos parámetros y mismos campos, con metric en views. Se añade links: los clics de cada uno de los enlaces de la página en el periodo. Ámbito Lectura.

curl "https://api.tinylink.fr/v1/pages/ma-page/stats?days=7" \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/pages/ma-page/stats?days=7', {
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/pages/ma-page/stats?days=7');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    'https://api.tinylink.fr/v1/pages/ma-page/stats?days=7',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()