API des clics par heure (v2)

Obtenez le nombre de clics par heure (00:00–23:59) sur une période définie.

Analysez la répartition du trafic horaire pour un lien, un groupe ou l’ensemble du compte.
Utilisez ces données pour mesurer les performances, identifier les heures clés et comprendre le comportement des utilisateurs.

Cette API est disponible à partir de l’offre Personal.

Documentation v2 (Legacy).

Pour les nouvelles intégrations, nous recommandons d’utiliser la version la plus récente, v3.
v2 est destinée à la maintenance des intégrations existantes et ne reçoit aucune nouvelle fonctionnalité ni amélioration.

GET

/api/statistics/v2/clicks-by-hour?ymd={ymd} 

{
    "ymd": "2025-04-20"
}

Request Parameters

ymd date required
Date de référence pour la requête. Exemple : 2025-04-20
linkId string
ID du lien. Si des caractères spéciaux ou Unicode sont inclus, un encodage URL est requis.
Forfait Personnel : linkId et domaine obligatoires, seules les statistiques de clics d’un lien individuel peuvent être récupérées.
Forfaits Premium ou supérieurs : saisie facultative.
domain string
Domaine du lien.
grpIdx integer
Groupe de liens. L’IDX du groupe peut être obtenu en appelant l’API Liste des Groupes ou en le consultant dans le tableau de bord.
Lorsqu’il est spécifié, le total des clics de tous les liens du groupe est renvoyé. Disponible uniquement avec les forfaits Premium ou supérieurs. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-20",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-20",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-20",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-20",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-20",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-20",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

Response Parameters

codeinteger
Code de réponse : 0 = Succès, toute autre valeur = Erreur
messagestring
Message de réponse. Si le code n’est pas 0, un message d’erreur correspondant est renvoyé.
resultarray
ymddate
Date.
hourinteger
Heure (0–23).
acesCntinteger
Nombre total de clics pendant la période spécifiée.
pernCntinteger
Nombre d’utilisateurs uniques ayant cliqué sur des liens pendant cette période.