API Analytics de Linkly

Exportez les données de clics et les rapports de trafic depuis Linkly de manière programmatique en utilisant notre API Analytics.

Connexe : API de raccourcissement de liens | Webhooks

Avant de commencer

Linkly génère des requêtes API dans l'interface pour que vous puissiez les copier et les coller dans vos applications.

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

Comment démarrer avec l'API Analytics

1

Ouvrez n'importe quel rapport de trafic dans Linkly.

2

Copiez la requête API affichée en haut du rapport.

Vous pouvez choisir entre CSV ou JSON. Ce lien contient votre clé API.

Ces liens sont présents à côté de chaque tableau et graphique dans Linkly.

Copiez la requête API affichée en haut du rapport.
Copiez la requête API affichée en haut du rapport.
3

Demandez à ChatGPT ou à un équivalent d'adapter ces requêtes en code source pour votre application.

Il n'est pas nécessaire de passer du temps à faire une intégration complexe.

Autorisation

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

Comment trouver vos identifiants API

1

Connectez-vous à Linkly.

2

Cliquez sur Paramètres.

3

Cliquez sur Clés API.

API des rapports de trafic

Linkly produit automatiquement des requêtes API pour vous à l'intérieur de vos rapports de trafic.

Linkly's Traffic Reports API
Linkly's Traffic Reports API

Les rapports de trafic de Linkly créent 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 :

FormatParamètreDescription
JSONformat=json (par défaut)Données structurées pour les applications
CSVformat=csvValeurs séparées par des virgules pour les feuilles de calcul
TSVformat=tsvValeurs séparées par des tabulations, idéal pour la visualisation dans le navigateur et le collage dans des feuilles de calcul

Mode pivot (format matriciel)

Par défaut, l'API renvoie des données de séries chronologiques avec une ligne par date. Avec le mode pivot, vous pouvez obtenir le trafic de tous vos liens en 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.

Export Data dropdown
Export Data dropdown

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

  • Les dates en lignes (une ligne par jour)
  • Les liens en colonnes (une colonne par lien)

Exemple de sortie pivot CSV/TSV

Mon lienAutre lien
nameMon lienAutre lien
full_urlhttps://linkly.link/abchttps://linkly.link/xyz
id123456
2025-12-304512
2025-12-31528
2026-01-013815

Exemple de sortie pivot JSON

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "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 entre plusieurs liens
  • Importer dans des feuilles de calcul pour l'analyse
  • Créer des tableaux de bord avec toutes les données de liens 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 dans les onglets en bas et choisissez votre format. Ce sont des requêtes API entièrement formées que vous pouvez utiliser directement dans votre application.

Export Raw Data
Export Raw Data
Raw Click Data Example
Raw Click Data Example

Remarques concernant l'exportation 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.

Notifications de clics en temps réel

Pour les notifications de clics en temps réel, voir Webhooks. Les webhooks envoient une requête POST à votre ou vos URL spécifiées immédiatement lorsqu'un clic se produit, 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 taux

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

Limites d'utilisation

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

Type de forfaitRequêtes APIDonnées analysées
Gratuit100/mois10 Go/mois
Payant mensuel2 000/mois2 To/mois
Payant annuel24 000/an24 To/an
Illimité mensuel10 000/mois2 To/mois
Illimité annuel120 000/an24 To/an

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.
  • Données analysées : La quantité de données traitées par notre base de données analytiques pour répondre à votre requête. Des plages de dates plus grandes et des requêtes plus complexes analysent plus de données.

Que se passe-t-il lorsque vous dépassez les limites

Si vous dépassez vos limites d'utilisation :

  1. 1Les requêtes API renverront une erreur 429 Too Many Requests
  2. 2Vos limites se réinitialiseront automatiquement au début de votre prochaine période de facturation
  3. 3Vos liens continueront de fonctionner et de suivre les clics normalement

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.

  • Utilisez 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
  • Mettez en cache les réponses : Stockez les réponses API localement au lieu de récupérer les mêmes données à plusieurs reprises
  • Utilisez des plages de dates plus petites : Interrogez uniquement les dates dont vous avez besoin
  • Regroupez les requêtes : Combinez plusieurs requêtes de liens en une seule requête en utilisant le paramètre link_ids

Besoin de plus ?

Si vous avez besoin de limites plus élevées, veuillez nous contacter en utilisant le widget d'assistance.

Intégration BigQuery

Pour des besoins analytiques à volume élevé, 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 - Pas de limites de taux d'API ; vous ne payez que pour le calcul BigQuery
  • Rapports personnalisés - Créez des tableaux de bord avec Looker, Data Studio ou Tableau
  • Consolidation de données - Joignez les données de clics avec d'autres métriques commerciales

L'intégration BigQuery est gratuite pour les clients du forfait Illimité, ou disponible en tant que module complémentaire à 100 $/mois pour les autres forfaits.

En savoir plus sur l'intégration BigQuery →

Connexe

Track 1000 monthly clicks with all features included.

No credit card required