Statistiques

Les vues d'une page et les clics d'un lien réduit, sur la période de votre choix, avec leur répartition par provenance, pays et appareil.

Clics d'un lien réduit

GET/v1/links/{id}/stats

?days= vaut 1, 7, 30 (par défaut), 90, ou 0 pour depuis toujours. Portée Lecture.

total — le total de la période ; previous_total celui de la période précédente et change_pct la variation en pourcentage
all_time_total — le total depuis la création
daily — la série par jour ; avec ?days=0, elle est remplacée par monthly, une entrée par mois (month, count)
referrers — la provenance : un nom de domaine, direct ou unknown
countries — le code du pays sur deux lettres, ou unknown
devices — desktop, mobile, tablet, console, tv ou unknown

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

const response = await fetch('https://api.tinylink.fr/v1/links/promo/stats?days=7', {
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
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_votre_jeton'],
]);
$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_votre_jeton'},
)
data = response.json()

Réponses possibles

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

Jeton absent de la requête

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

Jeton inconnu ou révoqué

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

L'offre du propriétaire n'inclut pas l'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."
  }
}

Le jeton ne porte pas la portée Lecture

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

Aucun lien réduit avec cet identifiant ou ce slug dans l'environnement

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

Période non proposée

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

Plus de 120 requêtes dans la minute

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

Vues d'une page

GET/v1/pages/{id}/stats

Mêmes paramètres et mêmes champs, avec metric à views. S'y ajoute links : les clics de chacun des liens de la page sur la période. Portée Lecture.

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

const response = await fetch('https://api.tinylink.fr/v1/pages/ma-page/stats?days=7', {
  headers: { Authorization: 'Bearer tl_votre_jeton' },
});
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_votre_jeton'],
]);
$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_votre_jeton'},
)
data = response.json()