Klicks nach Gruppe (v2)

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/v2/clicks-by-group?startYmd={startYmd}&endYmd={endYmd}&grpIdxList={grpIdxList}&pages={pages} 

{
    "startYmd": "2025-08-01",
    "endYmd": "2025-08-31",
    "grpIdxList": "151,207,209",
    "pages": 1
}

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
grpIdxList string

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.
pages integer required
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

code integer
Antwortcode: 0 = Erfolg, andere Werte = Fehler
message string
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
result object
extra object
Informationen zu Seiten und Datensätzen.
pages integer
Aktuelle Seitennummer
nextPages integer
Nächste Seitennummer
nextYn string
Ob eine nächste Seite existiert
count integer
Anzahl der Datensätze auf der aktuellen Seite
totalCount integer
Gesamtanzahl der Datensätze
list array
Klicks nach Gruppe
grpIdx integer
Link-Gruppe (IDX).
grpNm string
Name der Link-Gruppe.
acesCnt integer
Gesamtanzahl der Klicks aller Links in dieser Gruppe.
pernCnt integer
Anzahl der eindeutigen Nutzer, die auf Links in dieser Gruppe geklickt haben.