API Analytics de Linkly

Exportez les données de clics et les rapports de trafic de Linkly par programmation en utilisant notre API Analytics.

Lié : API de raccourcissement de liens | Webhooks

Avant de commencer

Linkly génère les requêtes API dans l'interface pour que vous les copiiez et les colliez dans vos applications.

Gagnez du temps et laissez-nous faire le travail difficile. Notre API est entièrement consommable par machine.

Autorisation

Vous aurez besoin de votre Clé API et ID de l'espace de travail. Vous pouvez obtenir ces détails depuis Linkly.

API des rapports de trafic

Linkly génère automatiquement des requêtes API pour vous dans vos rapports de trafic.

Les rapports de trafic de Linkly génèrent automatiquement des requêtes API pour vous, en fonction des données affichées à l'écran.

Ces liens incluent votre clé API et sont facilement personnalisables et utilisables dans vos propres applications.

Formats de sortie

L'API Analytics prend en charge trois formats de sortie :

Mode pivot (format matrice)

Par défaut, l'API renvoie des données de série chronologique avec une ligne par date. Avec le mode pivot, vous pouvez obtenir le trafic de tous vos liens dans une seule requête sous forme de matrice.

Utilisez le menu déroulant Exporter les données dans n'importe quel rapport de trafic pour exporter rapidement les données par lien, ou ajoutez pivot=link_id à votre requête API.

Ajoutez pivot=link_id à votre requête pour obtenir des données avec :

• Dates en lignes (une ligne par jour)
• Liens en colonnes (une colonne par lien)

Exemple de sortie pivot CSV/TSV

Exemple de sortie pivot JSON

{
  "links": [
    {"id": 123, "name": "Mon lien", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Autre lien", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Le mode pivot est utile pour :

• Comparer le trafic sur plusieurs liens
• Importer dans des feuilles de calcul pour analyse
• Créer des tableaux de bord avec toutes les données de lien en un seul appel

Données de clics brutes

Les données de clics brutes que nous enregistrons, y compris les paramètres complets, les horodatages et les informations de géolocalisation, sont disponibles.

Pour accéder à ces données, cliquez sur Exporter depuis les onglets en bas et choisissez votre format. Il s'agit de requêtes API entièrement formées que vous pouvez utiliser directement dans votre application.

Notes concernant l'export de données

• Envisagez de filtrer les données dans la vue d'abord pour réduire la quantité de données exportées. Cette fonction exporte les données sous-jacentes utilisées pour générer le rapport actuellement à l'écran.
• Ces données sont mises en cache pendant jusqu'à 3 heures. Les requêtes répétées à ce point de terminaison ne produiront pas de données en temps réel.

Comptages groupés

Le point de terminaison /counters/{dimension} renvoie les totaux de clics groupés par une seule dimension — comme country, platform, destination, referer, isp ou link_id. Les résultats reviennent classés par nombre de clics, du plus élevé au plus bas.

Un maximum de 10 000 valeurs sont renvoyées. Les dimensions à cardinalité élevée — destination, referer, remote_ip et isp — peuvent avoir beaucoup plus de valeurs distinctes que cela sur un espace de travail occupé. Quand c'est le cas, vous recevez les 10 000 principaux par nombre de clics et le reste n'est pas renvoyé.

Le champ total est toujours le total des clics sur tous les groupes, y compris ceux non renvoyés. Donc, sur un résultat tronqué, les valeurs count s'ajouteront à moins que total — ce qui signifie qu'un pourcentage calculé comme count / total est toujours exact.

Si vous avez besoin de l'ensemble complet des valeurs plutôt que des 10 000 premiers, exportez les données de clics brutes et agrégez-les vous-même, ou utilisez l'intégration BigQuery.

Notifications de clics en temps réel

Pour les notifications de clics en temps réel, consultez Webhooks. Les webhooks envoient une requête POST à votre ou vos URL spécifiées immédiatement lors d'un clic, avec des informations détaillées sur le clic.

Vous pouvez également gérer les webhooks via l'API - consultez la spécification OpenAPI pour plus de détails.

Politique d'utilisation équitable

Limites de débit

L'API Analytics est limitée à 50 requêtes par heure par espace de travail.

Limites d'utilisation

En plus des limites de débit, l'API Analytics a des limites d'utilisation qui se réinitialisent à chaque période de facturation :

Ce qui compte comme utilisation

• Requêtes API : Chaque appel aux points de terminaison de l'API Analytics (/clicks, /counters, /export) compte comme une requête. Les exports de liens (/links/export) effectués avec une clé API comptent également comme une requête.
• Données analysées : La quantité de données traitées par notre base de données analytics pour répondre à votre requête. Les plages de dates plus grandes et les requêtes plus complexes analysent plus de données.

Ce qui se passe si vous dépassez les limites

Quand un espace de travail sur un plan payant utilise toutes ses requêtes API, nous ajoutons automatiquement un forfait API à son abonnement pour que vos intégrations continuent à fonctionner, et nous envoyons un e-mail aux membres de l'espace de travail pour les informer. Un forfait API ajoute des requêtes API supplémentaires à chaque période de facturation jusqu'à ce que vous le supprimiez.

Les requêtes API renvoient une erreur 429 Too Many Requests à la place quand :

1. 1
   L'espace de travail se trouve sur le plan Gratuit ou Starter, qui ne peut pas ajouter de forfaits API
2. 2
   L'abonnement de l'espace de travail est défini sur annulation, ou un paiement est en retard
3. 3
   L'espace de travail a utilisé toute son allocation de données analysées — les forfaits API ajoutent des requêtes, pas des données

Les limites d'utilisation se réinitialisent au début de chaque période de facturation, et vos liens continuent à fonctionner et à suivre les clics normalement de toute façon.

Conseils pour réduire l'utilisation

La plupart des utilisateurs peuvent obtenir toutes leurs données en une seule requête API en utilisant le mode pivot (pivot=link_id), qui renvoie le trafic de tous les liens sous forme de matrice en un seul appel.

• Utiliser le mode pivot : Ajoutez pivot=link_id pour obtenir le trafic de tous les liens en une seule requête au lieu d'interroger chaque lien séparément
• Mettre en cache les réponses : Stockez les réponses API localement au lieu de récupérer les mêmes données à plusieurs reprises
• Utiliser des plages de dates plus petites : Interrogez uniquement les dates dont vous avez besoin
• Grouper les requêtes : Combinez plusieurs requêtes de lien en une seule requête en utilisant le paramètre link_ids

Besoin de plus ?

Vous pouvez ajouter des forfaits API vous-même à tout moment sous Add-ons sur la page Facturation. Chaque forfait ajoute des requêtes API supplémentaires à chaque période de facturation ; la page affiche le prix pour votre forfait avant que vous confirmiez.

Les forfaits API ne changent pas la limite de débit. Si vous avez besoin d'une limite de débit plus élevée, veuillez nous contacter en utilisant le widget d'assistance.

Intégration BigQuery

Pour les besoins analytiques à haut volume, Linkly propose une intégration BigQuery qui fournit un accès SQL direct à vos données de clics.

• Accès aux données en direct - Interrogez vos données de clics directement dans BigQuery avec des mises à jour en temps réel
• Requêtes illimitées - Aucune limite de débit API ; vous payez uniquement pour le calcul BigQuery
• Rapports personnalisés - Créez des tableaux de bord avec Looker, Data Studio ou Tableau
• Consolidation des données - Joignez les données de clics avec d'autres métriques métier

L'intégration BigQuery est incluse dans le plan Enterprise. Contactez-nous pour plus de détails.

En savoir plus sur l'intégration BigQuery →

Associé

• API de raccourcissement de liens - Créez et mettez à jour des liens par programmation
• Webhooks - Notifications de clics en temps réel
• Intégration BigQuery - Accès SQL direct aux données de clics
• Intégration Zapier - Intégrations sans code