Estadísticas

Las vistas y los clics en el periodo que elijas, para un elemento, para los elementos de una etiqueta o para todo el espacio de trabajo, con su reparto por procedencia, país y dispositivo.

GET/v1/links/{id}/statsClics de un enlace corto
GET/v1/pages/{id}/statsVistas de una página
GET/v1/statsEstadísticas del espacio de trabajo
GET/v1/tags/{id}/statsEstadísticas de una etiqueta

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()

Respuestas posibles

{
  "metric": "views",
  "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
    }
  ],
  "links": [
    {
      "id": "L6ac4011edb7c6",
      "title": "Mi sitio",
      "clicks": 19
    },
    {
      "id": "L6ac4011ee9fab",
      "title": "Contact",
      "clicks": 4
    }
  ]
}

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"
    }
  }
}

Ninguna página con este identificador o este slug en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Page 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."
  }
}

Estadísticas del espacio de trabajo

GET/v1/stats

Las cifras de todo el espacio de trabajo del token, como en el panel. ?days= vale 1, 7, 30 (por defecto), 90, o 0 para desde siempre; ?limit= (de 1 a 100, 10 por defecto) fija la longitud de las clasificaciones. Ámbito Lectura.

page_views: las vistas de las páginas; page_link_clicks: los clics en los enlaces de esas páginas; short_link_clicks: los clics de los enlaces cortos. Cada uno lleva total, previous_total, change_pct y all_time_total, como las estadísticas de un elemento
click_through_rate: la parte de las vistas de páginas seguidas de un clic, en porcentaje (value), y la del periodo anterior (previous_value); null sin vistas
daily: una entrada por día con los tres contadores; con ?days=0 se sustituye por monthly, una entrada por mes
referrers, countries, devices: la procedencia, el país y el dispositivo de las vistas de páginas y de los clics de enlaces cortos, en el mismo formato que para un elemento
top_pages: las páginas más vistas del periodo, con sus vistas y los clics en sus enlaces; top_links: los enlaces cortos con más clics

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

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

$ch = curl_init('https://api.tinylink.fr/v1/stats?days=7&limit=1');
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/stats?days=7&limit=1',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "days": 7,
  "from": "2026-09-29",
  "to": "2026-10-05",
  "page_views": {
    "total": 104,
    "previous_total": 88,
    "change_pct": 18.2,
    "all_time_total": 1240
  },
  "page_link_clicks": {
    "total": 42,
    "previous_total": 40,
    "change_pct": 5.0,
    "all_time_total": 517
  },
  "short_link_clicks": {
    "total": 50,
    "previous_total": 62,
    "change_pct": -19.4,
    "all_time_total": 688
  },
  "click_through_rate": {
    "value": 40.4,
    "previous_value": 45.5
  },
  "daily": [
    {
      "date": "2026-09-29",
      "page_views": 12,
      "page_link_clicks": 5,
      "short_link_clicks": 8
    },
    {
      "date": "2026-09-30",
      "page_views": 18,
      "page_link_clicks": 7,
      "short_link_clicks": 6
    },
    {
      "date": "2026-10-01",
      "page_views": 9,
      "page_link_clicks": 3,
      "short_link_clicks": 11
    },
    {
      "date": "2026-10-02",
      "page_views": 15,
      "page_link_clicks": 6,
      "short_link_clicks": 4
    },
    {
      "date": "2026-10-03",
      "page_views": 22,
      "page_link_clicks": 9,
      "short_link_clicks": 7
    },
    {
      "date": "2026-10-04",
      "page_views": 17,
      "page_link_clicks": 8,
      "short_link_clicks": 9
    },
    {
      "date": "2026-10-05",
      "page_views": 11,
      "page_link_clicks": 4,
      "short_link_clicks": 5
    }
  ],
  "referrers": [
    {
      "source": "instagram.com",
      "count": 71
    },
    {
      "source": "direct",
      "count": 58
    },
    {
      "source": "t.co",
      "count": 17
    },
    {
      "source": "QR Code",
      "count": 8
    }
  ],
  "countries": [
    {
      "country": "FR",
      "count": 118
    },
    {
      "country": "BE",
      "count": 21
    },
    {
      "country": "CA",
      "count": 9
    },
    {
      "country": "unknown",
      "count": 6
    }
  ],
  "devices": [
    {
      "device": "mobile",
      "count": 109
    },
    {
      "device": "desktop",
      "count": 41
    },
    {
      "device": "tablet",
      "count": 4
    }
  ],
  "top_pages": [
    {
      "id": "P6ac4011ea1b2c",
      "name": "Mi página",
      "url": "https://tnylnk.fr/mi-pagina",
      "views": 104,
      "link_clicks": 42
    }
  ],
  "top_links": [
    {
      "id": "6ac401093831b",
      "url": "https://tnlnk.fr/promo",
      "target_url": "https://ejemplo.es/promo",
      "clicks": 50
    }
  ]
}

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"
    }
  }
}

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"
    }
  }
}

Longitud de clasificación fuera de 1 a 100

{
  "error": {
    "code": "validation_failed",
    "message": "The \"limit\" parameter must be between 1 and 100.",
    "details": {
      "field": "limit"
    }
  }
}

Más de 120 peticiones en el minuto

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

Estadísticas de una etiqueta

GET/v1/tags/{id}/stats

Las mismas cifras, limitadas a las páginas y enlaces cortos que llevan la etiqueta, con los mismos parámetros. Se añade tag, la propia etiqueta. Con ?limit=100, top_pages y top_links dan las cifras de cada uno de los elementos de la etiqueta (100 como máximo de cada tipo). Ámbito Lectura.

curl "https://api.tinylink.fr/v1/tags/46/stats?days=7&limit=1" \
  -H "Authorization: Bearer tl_tu_token"

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

$ch = curl_init('https://api.tinylink.fr/v1/tags/46/stats?days=7&limit=1');
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/tags/46/stats?days=7&limit=1',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "tag": {
    "id": 46,
    "name": "Campaña",
    "color": "#1E90FF",
    "elements_count": 2,
    "created_at": "2026-10-05T21:56:57+02:00"
  },
  "days": 7,
  "from": "2026-09-29",
  "to": "2026-10-05",
  "page_views": {
    "total": 104,
    "previous_total": 88,
    "change_pct": 18.2,
    "all_time_total": 1240
  },
  "page_link_clicks": {
    "total": 42,
    "previous_total": 40,
    "change_pct": 5.0,
    "all_time_total": 517
  },
  "short_link_clicks": {
    "total": 50,
    "previous_total": 62,
    "change_pct": -19.4,
    "all_time_total": 688
  },
  "click_through_rate": {
    "value": 40.4,
    "previous_value": 45.5
  },
  "daily": [
    {
      "date": "2026-09-29",
      "page_views": 12,
      "page_link_clicks": 5,
      "short_link_clicks": 8
    },
    {
      "date": "2026-09-30",
      "page_views": 18,
      "page_link_clicks": 7,
      "short_link_clicks": 6
    },
    {
      "date": "2026-10-01",
      "page_views": 9,
      "page_link_clicks": 3,
      "short_link_clicks": 11
    },
    {
      "date": "2026-10-02",
      "page_views": 15,
      "page_link_clicks": 6,
      "short_link_clicks": 4
    },
    {
      "date": "2026-10-03",
      "page_views": 22,
      "page_link_clicks": 9,
      "short_link_clicks": 7
    },
    {
      "date": "2026-10-04",
      "page_views": 17,
      "page_link_clicks": 8,
      "short_link_clicks": 9
    },
    {
      "date": "2026-10-05",
      "page_views": 11,
      "page_link_clicks": 4,
      "short_link_clicks": 5
    }
  ],
  "referrers": [
    {
      "source": "instagram.com",
      "count": 71
    },
    {
      "source": "direct",
      "count": 58
    },
    {
      "source": "t.co",
      "count": 17
    },
    {
      "source": "QR Code",
      "count": 8
    }
  ],
  "countries": [
    {
      "country": "FR",
      "count": 118
    },
    {
      "country": "BE",
      "count": 21
    },
    {
      "country": "CA",
      "count": 9
    },
    {
      "country": "unknown",
      "count": 6
    }
  ],
  "devices": [
    {
      "device": "mobile",
      "count": 109
    },
    {
      "device": "desktop",
      "count": 41
    },
    {
      "device": "tablet",
      "count": 4
    }
  ],
  "top_pages": [
    {
      "id": "P6ac4011ea1b2c",
      "name": "Mi página",
      "url": "https://tnylnk.fr/mi-pagina",
      "views": 104,
      "link_clicks": 42
    }
  ],
  "top_links": [
    {
      "id": "6ac401093831b",
      "url": "https://tnlnk.fr/promo",
      "target_url": "https://ejemplo.es/promo",
      "clicks": 50
    }
  ]
}

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"
    }
  }
}

Ninguna etiqueta con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Tag 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"
    }
  }
}

Longitud de clasificación fuera de 1 a 100

{
  "error": {
    "code": "validation_failed",
    "message": "The \"limit\" parameter must be between 1 and 100.",
    "details": {
      "field": "limit"
    }
  }
}

Más de 120 peticiones en el minuto

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

Clics de un enlace corto

Vistas de una página

Estadísticas del espacio de trabajo

Estadísticas de una etiqueta

¿No encuentras tu respuesta?