Klicks nach Gruppe

API zum Abrufen der Klickzahlen nach Linkgruppe für ein angegebenes Datum.

Gibt eine Liste mit der Gesamtanzahl der Klicks aller Links innerhalb jeder Gruppe zurück.

Pro Anfrage können maximal 30 Gruppen abgerufen werden. Um mehr Gruppen abzurufen, verwenden Sie den Parameter pages und rufen die API mehrfach auf.

Diese API ist in Premium-Tarifen oder höher verfügbar.

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

ymddaterequired
Abfragedatum. Beispiel: 2025-08-01
grpIdxListstring

Liste der Gruppen-IDs, durch Kommas (,) getrennt angeben. Beispiel: 151,207,209

  • Premium-Tarif: Die Gruppen-IDs müssen angegeben werden, maximal 5 Gruppen.
  • Business-Tarif: Wenn weggelassen, werden Klicks aller Gruppen abgerufen. Es können beliebig viele Gruppen angegeben werden.
pagesintegerrequired
Default:1
Seitennummer der Ergebnisse.
Standardmäßig werden pro Seite 30 Ergebnisse zurückgegeben. Beispiel: Wenn pages=2, werden ab dem 31. Eintrag 30 Ergebnisse zurückgegeben. 
{
    "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

codeinteger
Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultobject
extraobject
Informationen zu Seiten und Datensätzen.
pagesinteger
Aktuelle Seitennummer
nextPagesinteger
Nächste Seitennummer
nextYnstring
Ob eine nächste Seite existiert
countinteger
Anzahl der Datensätze auf der aktuellen Seite
totalCountinteger
Gesamtanzahl der Datensätze
listarray
Klicks nach Gruppe
grpIdxinteger
Link-Gruppe (IDX).
grpNmstring
Name der Link-Gruppe.
acesCntinteger
Gesamtanzahl der Klicks aller Links in dieser Gruppe.
pernCntinteger
Anzahl der eindeutigen Nutzer, die auf Links in dieser Gruppe geklickt haben.