API des clics mensuels

Obtenez le nombre de clics par mois (YYYY-MM) sur une période définie.

Analysez les tendances de trafic à long terme et les dynamiques de croissance afin de mieux comprendre les performances des campagnes et le comportement des utilisateurs.

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

GET

/api/statistics/v1/clicks-by-month?startYm={startYm}&endYm={endYm} 


GET /api/statistics/v1/clicks-by-month
     ?startYm=2026-01
     &endYm=2026-04

Request Parameters

startYm string required
Année et mois de début de la requête. Format YYYY-MM. Exemple : 2026-01
endYm string required
Année et mois de fin de la requête. Format YYYY-MM. Exemple : 2026-04
La plage autorisée dépend de l’offre choisie.
Personal : 90 derniers jours
Premium : 180 derniers jours
Business : 365 derniers jours
linkId string
ID du lien. Si des caractères spéciaux ou Unicode sont inclus, appliquez un URL encoding.
Personal : linkId et domain requis. Seuls les liens individuels peuvent être consultés.
Premium et supérieur : optionnel.
domain string
Domaine du lien. Les domaines personnalisés sont pris en charge.
grpIdx integer
ID du groupe de liens. Vous pouvez le récupérer via l’API des groupes ou depuis le tableau de bord.
Si spécifié, le total des clics de tous les liens du groupe est retourné.
Disponible à partir de l’offre Premium. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ym": "2026-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2026-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2026-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2026-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        }
    ]
}

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
ym string
Année et mois, retournés au format YYYY-MM. Exemple : 2026-01
acesCnt integer
Nombre total de clics pour le mois spécifié.
pernCnt integer
Nombre d’utilisateurs uniques ayant cliqué sur le lien pendant ce mois.

Quand utiliser cette API

Utilisez cette API pour analyser les tendances de trafic des liens sur une base mensuelle.

Elle est idéale pour résumer les performances trimestrielles ou semestrielles, analyser les tendances saisonnières et préparer des rapports annuels.

Par rapport à l’API des clics par date, elle est plus adaptée à une analyse des tendances à long terme.

Différence avec l’API des clics par date

L’API des clics par date agrège les données par jour et convient aux analyses à court terme, tandis que l’API mensuelle agrège par mois pour des analyses à long terme.
Selon l’offre, elle permet d’interroger jusqu’à 365 jours, ce qui la rend adaptée aux analyses annuelles.
※ Les offres Business Plus et Enterprise peuvent aller jusqu’à 2 ans selon les conditions contractuelles

Limites de requête par offre

Cette API est disponible à partir de l’offre Personal. La plage de requête varie selon l’offre.

L’offre Personal permet jusqu’à 90 jours, Premium jusqu’à 180 jours et Business jusqu’à 365 jours.
Les requêtes par groupe via grpIdx sont disponibles uniquement avec l’offre Premium ou supérieure.

Indicateurs clés et analyse

Cette API fournit des données agrégées mensuelles.

Clics mensuels (accsCnt)

  • Nombre total de clics par mois
  • Suivi des tendances de croissance ou de baisse

Utilisateurs (pernCnt)

  • Nombre d’utilisateurs uniques par mois
  • Mesure du volume réel de trafic

Ces indicateurs permettent d’analyser la croissance, les tendances saisonnières et la performance à long terme.

Cas d’utilisation

  • Rapports trimestriels : Définissez la période avec startYm et endYm pour analyser les tendances mensuelles
  • Analyse saisonnière : Analysez une année de données pour identifier les mois à fort trafic
  • Tendances de campagne : Utilisez grpIdx pour analyser les clics mensuels d’un groupe
  • Rapports annuels : Avec l’offre Business, collectez jusqu’à 365 jours de données

Points à considérer

  • startYm et endYm sont obligatoires et doivent respecter le format YYYY-MM.
  • La plage maximale dépend de l’offre. Un dépassement entraînera une erreur.
  • Si linkId contient des caractères spéciaux ou Unicode, un URL encoding est requis.
  • Cette API est disponible à partir de l’offre Personal. Vérifiez votre abonnement avant utilisation.