POST AI agent ready /v1/short-url/stats

API de statistiques d'URL courtes - Analyse de clics gratuite

Soumettez le slug d'une URL raccourcie et recevez son nombre de clics, son URL d'origine et son horodatage de création. Utilisez-le pour suivre l'engagement sur les liens créés via le point de terminaison /v1/short-url/create. Les statistiques sont mises à jour en temps réel lorsque les utilisateurs cliquent sur le lien court.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/short-url/stats \
  -H "Content-Type: application/json" \
  -d '{"slug":"getting-started"}'

When to use this API

Suivez les performances des liens de campagne dans votre tableau de bord d'administration

Interrogez le point de terminaison des statistiques pour chaque lien de campagne et affichez le nombre de clics à côté des données de conversion. Cela donne à votre équipe marketing une vision claire des canaux qui génèrent du trafic.

Déclencher l'automatisation lorsqu'un lien atteint un seuil de clic

Vérifiez périodiquement le nombre de clics. Lorsqu'un lien franchit un seuil (par exemple 1 000 clics), déclenchez une notification, faites pivoter le lien ou mettez à jour un classement.

Créer une page de rapport pour les liens partagés

Montrez aux créateurs de liens combien de clics ont reçu leurs URL courtes. Affichez l'URL d'origine, la date de création et le nombre total de clics dans une vue analytique simple.

Frequently asked questions

Le nombre de clics est-il mis à jour en temps réel ?

Oui. Le compteur s'incrémente à chaque redirection. Il peut y avoir un délai inférieur à une seconde en raison d'une éventuelle cohérence dans le magasin clé-valeur, mais pour des raisons pratiques, il est instantané.

Puis-je réinitialiser le compteur de clics ?

Non. Il n’existe aucun point final pour réinitialiser le nombre de clics. Si vous avez besoin d'un nouveau compteur, créez un nouveau lien court avec un slug différent.

Que se passe-t-il si le slug n'existe pas ?

L'API renvoie une erreur 404 avec le code NOT_FOUND. Vérifiez à nouveau l’orthographe du slug ou créez un nouveau lien court.

Le point de terminaison des statistiques compte-t-il le trafic des robots séparément ?

Non. Le compteur de clics suit toutes les demandes de redirection, y compris les robots, les robots d'exploration et les récupérateurs d'aperçus. Filtrez le trafic des robots de votre côté si nécessaire.

Puis-je obtenir des statistiques sur les liens créés par d'autres utilisateurs ?

Oui. Les statistiques sont accessibles à toute personne connaissant la limace. Il n’y a aucune propriété ni contrôle d’accès sur les liens courts individuels.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.