API für Klicks nach Gruppen (v1)

Rufen Sie die Klickzahlen pro Linkgruppe für ein bestimmtes Datum ab.

Die API summiert die Klicks aller Links innerhalb jeder Gruppe und gibt sie als Liste zurück.
So können Sie mehrere Gruppen gleichzeitig vergleichen und die Kampagnenleistung auf einen Blick bewerten.

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

v1-Dokumentation (Legacy).

Für neue Integrationen empfehlen wir die Verwendung der neuesten Version v2.
v1 dient der Aufrechterhaltung bestehender Integrationen und erhält keine neuen Funktionen oder Verbesserungen.

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

ymd date required
Abfragedatum. Beispiel: 2025-08-01
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.