Klicks nach Uhrzeit

API zum Abrufen der stündlichen Klicks für ein angegebenes Datum (00:00–23:59).

Abfragebedingungen

  • Sowohl linkId + domain angegeben → Stündliche Klicks für diesen Link abrufen.
  • grpIdx angegeben → Gesamte stündliche Klicks der Links in dieser Gruppe abrufen.
  • Keine Bedingung → Stündliche Klicks für das gesamte Konto abrufen.

Diese API wird verwendet, um die Verteilung des Klick-Traffics an einem bestimmten Datum zu analysieren.
Nützlich für die Messung von Event-Ergebnissen, die Ermittlung von Spitzenzeiten im Marketing und die Analyse von Nutzeraktivitätsmustern.

Diese API ist in Tarifen ab Personal verfügbar.

GET

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

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

Request Parameters

ymddaterequired
Abfragedatum. Beispiel: 2025-04-20
linkIdstring
Link-ID. Wenn Sonderzeichen oder Unicode enthalten sind, ist URL-Encoding erforderlich.
Personal-Tarif: linkId und Domain erforderlich, es können nur Klicks einzelner Links abgefragt werden.
Premium-Tarife oder höher: optionale Eingabe.
domainstring
Link-Domain.
grpIdxinteger
Link-Gruppe. Die Gruppen-IDX kann über den Gruppenlisten-API abgerufen oder im Dashboard eingesehen werden.
Wenn angegeben, wird die Gesamtsumme der Klicks aller Links in dieser Gruppe zurückgegeben. Nur in Premium-Tarifen oder höher verfügbar.
{
    "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
Antwortcode: 0 = Erfolgreich, jeder andere Wert = Fehler
messagestring
Antwortnachricht. Wenn der Antwortcode ungleich 0 ist, wird eine Fehlermeldung zurückgegeben.
resultarray
ymddate
Datum.
hourinteger
Stunde (0–23).
acesCntinteger
Gesamtanzahl der Klicks im angegebenen Zeitraum.
pernCntinteger
Anzahl der eindeutigen Nutzer, die in diesem Zeitraum auf Links geklickt haben.