API des clics par groupe (v1)

Obtenez le nombre de clics par groupe de liens pour une date donnée.

L’API agrège les clics de tous les liens au sein de chaque groupe et les renvoie sous forme de liste.
Comparez plusieurs groupes simultanément pour évaluer les performances de vos campagnes en un coup d’œil.

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

Documentation v1 (Legacy).

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

GET

/api/link/v1/clicks-by-group?ymd={ymd}&grpIdxList={grpIdxList}&pages={pages} 

{
    "ymd": "2025-08-01",
    "grpIdxList": "151,207,209",
    "pages": 1
}

Request Parameters

ymd date required
Date de référence pour la requête. Exemple : 2025-08-01
grpIdxList string

Fournir la liste des IDX de groupes séparés par des virgules (,). Exemple : 151,207,209

  • Forfait Premium : La liste des IDX de groupes doit être spécifiée, maximum 5 groupes.
  • Forfait Business : Si omis, les clics de tous les groupes seront récupérés. Il est également possible de spécifier un nombre illimité de groupes.
pages integer required
Default:1
Numéro de page des résultats.
Chaque page renvoie 30 résultats par défaut. Exemple : si pages=2, les résultats sont renvoyés à partir du 31e enregistrement (30 éléments). 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 3,
            "totalCount": 3
        },
        "list": [
            {
                "grpIdx": 151,
                "grpNm": "Electronics",
                "acesCnt": 181,
                "pernCnt": 164
            },
            {
                "grpIdx": 207,
                "grpNm": "Kitchenware",
                "acesCnt": 19847,
                "pernCnt": 18095
            },
            {
                "grpIdx": 209,
                "grpNm": "Brian Smith Advertiser Only",
                "acesCnt": 5730,
                "pernCnt": 5409
            }
        ]
    }
}

Response Parameters

code integer
Code de réponse : 0 = Succès, autres valeurs = Erreur
message string
Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
result object
extra object
Informations sur la page et le nombre de données.
pages integer
Numéro de la page actuelle
nextPages integer
Numéro de la page suivante
nextYn string
Indique s’il existe une page suivante
count integer
Nombre d’enregistrements sur la page actuelle
totalCount integer
Nombre total d’enregistrements
list array
Clics par Groupe
grpIdx integer
Groupe de liens (IDX).
grpNm string
Nom du groupe de liens.
acesCnt integer
Nombre total de clics pour tous les liens de ce groupe.
pernCnt integer
Nombre d’utilisateurs uniques ayant cliqué sur les liens de ce groupe.