Clics par heure

API pour récupérer le nombre de clics horaires pour une date donnée (00:00–23:59).

Conditions de requête

  • linkId + domain spécifiés → Récupère les clics horaires de ce lien.
  • grpIdx spécifié → Récupère le total des clics horaires des liens du groupe.
  • Aucune condition → Récupère les clics horaires de l’ensemble du compte.

Cette API est utilisée pour analyser la répartition du trafic de clics sur une date précise.
Utile pour mesurer la performance d’événements, identifier les heures de pointe marketing et analyser les comportements des utilisateurs.

Cette API est disponible avec les forfaits Personal et supérieurs.

GET

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

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

Request Parameters

ymddaterequired
Date de référence pour la requête. Exemple : 2025-04-20
linkIdstring
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.
domainstring
Domaine du lien.
grpIdxinteger
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.