Clics par date

API pour récupérer le nombre de clics quotidiens (YYYY-MM-DD) sur une période donnée.

Conditions de requête

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

Cette API est utile pour analyser l’évolution du trafic de clics sur une période définie.
Elle peut être utilisée pour mesurer la performance marketing, identifier les tendances de campagnes et analyser les flux d’acquisition des utilisateurs.

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

GET

/api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd}

{
    "startYmd": "2025-04-01",
    "endYmd": "2025-04-30"
}

Request Parameters

startYmddaterequired
Date de début de la requête (exemple : 2025-04-01)
endYmddaterequired
Date de fin de la requête (exemple : 2025-04-30). La plage maximale entre la date de début et la date de fin est d’un mois.
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-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2025-04-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2025-04-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2025-04-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        },
        {
            "ymd": "2025-04-05",
            "acesCnt": 171,
            "pernCnt": 164
        }
    ]
}

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.
acesCntinteger
Nombre total de clics à la date indiquée.
pernCntinteger
Nombre d’utilisateurs uniques ayant cliqué sur des liens à cette date.