Klicks nach Uhrzeit (v3)

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/v3/clicks-by-hour?startYmd={startYmd}&endYmd={endYmd} 

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

Request Parameters

startYmd date required
Startdatum der Abfrage (z. B. 2025-12-01)
endYmd date required
Enddatum der Abfrage (z. B. 2025-12-31). Der maximale Zeitraum zwischen Start- und Enddatum beträgt 1 Monat.
Personal-Tarif: bis zu 7 Tage
Premium-Tarif: bis zu 14 Tage
linkId string
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.
domain string
Link-Domain.
grpIdx integer
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-01",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-02",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-03",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-04",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-05",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-10",
            "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.