API für monatliche Klickstatistiken

Rufen Sie die monatlichen Klickzahlen (YYYY-MM) für einen bestimmten Zeitraum ab.

Analysieren Sie langfristige Traffic-Trends und Wachstumsentwicklungen, um die Kampagnenleistung und das Nutzerverhalten besser zu verstehen.

Diese API ist im Personal-Tarif und höher verfügbar.

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
Startjahr und -monat der Abfrage. Format: YYYY-MM. Beispiel: 2026-01
endYm string required
Endjahr und -monat der Abfrage. Format: YYYY-MM. Beispiel: 2026-04
Der zulässige Zeitraum hängt vom gewählten Tarif ab.
Personal: letzte 90 Tage
Premium: letzte 180 Tage
Business: letzte 365 Tage
linkId string
Link-ID. Enthält sie Sonderzeichen oder Unicode, muss URL-Encoding angewendet werden.
Personal: linkId und domain sind erforderlich. Es können nur einzelne Links abgefragt werden.
Premium und höher: optional.
domain string
Link-Domain. Auch benutzerdefinierte Domains werden unterstützt.
grpIdx integer
Linkgruppen-ID. Die IDX kann über die Gruppenlisten-API oder im Dashboard abgerufen werden.
Bei Angabe wird die Gesamtzahl aller Klicks innerhalb der Gruppe zurückgegeben.
Verfügbar ab Premium-Tarif. 
{
    "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
Antwortcode: 0 = Erfolgreich, jeder andere Wert = Fehler
messagestring
Antwortnachricht. Wenn der Antwortcode ungleich 0 ist, wird eine Fehlermeldung zurückgegeben.
resultarray
ym string
Jahr und Monat, zurückgegeben im Format YYYY-MM. Beispiel: 2026-01
acesCnt integer
Gesamtzahl der Klicks im angegebenen Monat.
pernCnt integer
Anzahl der eindeutigen Nutzer, die im angegebenen Monat auf den Link geklickt haben.

Wann diese API verwenden

Verwenden Sie diese API, um Traffic-Trends von Links auf monatlicher Basis zu analysieren.

Sie eignet sich besonders zur Auswertung von Quartals- oder Halbjahreskampagnen, zur Analyse saisonaler Muster und zur Erstellung jährlicher Berichte.

Im Vergleich zur Klicks nach Datum API ist sie besser für langfristige Trendanalysen geeignet.

Unterschied zur Klicks nach Datum API

Die Klicks nach Datum API aggregiert Daten täglich und eignet sich für kurzfristige Analysen, während die monatliche API Daten monatlich aggregiert und für langfristige Analysen geeignet ist.
Je nach Tarif können Daten bis zu 365 Tage abgefragt werden, was sie ideal für Jahresanalysen macht.
※ Business Plus- und Enterprise-Tarife können je nach Vertrag bis zu 2 Jahre unterstützen

Abfragelimits nach Tarif

Diese API ist ab dem Personal-Tarif verfügbar. Der Abfragezeitraum variiert je nach Tarif.

Der Personal-Tarif erlaubt bis zu 90 Tage, Premium bis zu 180 Tage und Business bis zu 365 Tage.
Gruppenabfragen über grpIdx sind nur im Premium-Tarif und höher verfügbar.

Wichtige Kennzahlen und Analyse

Diese API liefert monatlich aggregierte Daten.

Monatliche Klicks (accsCnt)

  • Gesamtzahl der Klicks pro Monat
  • Analyse von Wachstums- oder Rückgangstrends

Nutzer (pernCnt)

  • Anzahl der eindeutigen Nutzer pro Monat
  • Messung des tatsächlichen Traffic-Volumens

Diese Kennzahlen helfen bei der Analyse von Wachstum, saisonalen Mustern und langfristiger Performance.

Anwendungsfälle

  • Quartalsberichte: Definieren Sie den Zeitraum mit startYm und endYm, um monatliche Trends zu analysieren
  • Saisonalitätsanalyse: Analysieren Sie ein Jahr, um Monate mit hohem Traffic zu identifizieren
  • Langfristige Kampagnenanalyse: Nutzen Sie grpIdx, um monatliche Klicktrends einer Gruppe auszuwerten
  • Jahresberichte: Mit dem Business-Tarif können bis zu 365 Tage für Jahresanalysen genutzt werden

Wichtige Hinweise

  • startYm und endYm sind Pflichtparameter und müssen im Format YYYY-MM angegeben werden.
  • Der maximale Zeitraum hängt vom Tarif ab. Bei Überschreitung wird ein Fehler zurückgegeben.
  • Enthält linkId Sonderzeichen oder Unicode, ist URL-Encoding erforderlich.
  • Diese API ist ab dem Personal-Tarif verfügbar. Bitte prüfen Sie Ihren Tarif vor der Nutzung.