Linkly's Analytics API

Exportieren Sie Clickdaten und Verkehrsberichte aus Linkly programmatisch mit unserer Analytics API.

Verwandt: Link-Verkkürzungs-API | Webhooks

Bevor Sie beginnen

Linkly generiert API-Anfragen in der Benutzeroberfläche, die Sie kopieren und in Ihre Anwendungen einfügen können.

Sparen Sie Zeit und lassen Sie uns die schwere Arbeit erledigen. Unsere API ist vollständig maschinenlesbar.

Authentifizierung

Sie benötigen Ihren API-Schlüssel und Ihre Workspace-ID. Sie können diese Details in Linkly finden.

Verkehrsberichte API

Linkly generiert automatisch API-Anfragen für Sie in Ihren Verkehrsberichten.

Die Verkehrsberichte von Linkly erstellen automatisch API-Anfragen für Sie, basierend auf den auf dem Bildschirm angezeigten Daten.

Diese Links enthalten Ihren API-Schlüssel und sind leicht anpassbar und in Ihren eigenen Anwendungen nutzbar.

Ausgabeformate

Die Analytics API unterstützt drei Ausgabeformate:

Pivot-Modus (Matrixformat)

Standardmäßig gibt die API Zeitreihendaten mit einer Zeile pro Datum zurück. Mit dem Pivot-Modus können Sie alle Ihren Links' Verkehr in einer einzelnen Anfrage als Matrix abrufen.

Verwenden Sie die Dropdown-Liste Daten exportieren in einem beliebigen Verkehrsbericht, um Daten schnell nach Link zu exportieren, oder fügen Sie pivot=link_id zu Ihrer API-Anfrage hinzu.

Fügen Sie pivot=link_id zu Ihrer Anfrage hinzu, um Daten zu erhalten mit:

• Daten als Zeilen (eine Zeile pro Tag)
• Links als Spalten (eine Spalte pro Link)

CSV/TSV-Pivot-Ausgabebeispiel

JSON-Pivot-Ausgabebeispiel

{
  "links": [
    {"id": 123, "name": "Mein Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Anderer Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Der Pivot-Modus ist nützlich für:

• Vergleich des Verkehrs über mehrere Links
• Import in Tabellenkalkulationen zur Analyse
• Erstellen von Dashboards mit allen Link-Daten in einem Aufruf

Rohclick-Daten

Die Rohclick-Daten, die wir aufzeichnen, einschließlich vollständiger Parameter, Zeitstempel und Geolokalisierungsinformationen, sind verfügbar.

Um auf diese Daten zuzugreifen, klicken Sie auf Exportieren in den Registerkarten am unteren Rand und wählen Sie Ihr Format. Dies sind vollständig ausgebildete API-Anfragen, die Sie direkt in Ihrer Anwendung verwenden können.

Hinweise zum Datenexport

• Erwägen Sie, Daten zunächst in der Ansicht zu filtern, um die Menge der exportierten Daten zu reduzieren. Diese Funktion exportiert die zugrunde liegenden Daten, die zur Generierung des aktuell auf dem Bildschirm angezeigten Berichts verwendet werden.
• Diese Daten werden bis zu 3 Stunden lang zwischengespeichert. Wiederholte Anfragen an diesen Endpunkt führen nicht zu Echtzeitdaten.

Gruppierte Zählungen

Der Endpunkt /counters/{dimension} gibt Click-Summen zurück, die nach einer einzelnen Dimension gruppiert sind — wie country, platform, destination, referer, isp oder link_id. Die Ergebnisse werden nach Click-Zählung sortiert, höchste zuerst.

Es werden maximal 10.000 Werte zurückgegeben. High-Cardinality-Dimensionen — destination, referer, remote_ip und isp — können viel mehr unterschiedliche Werte haben als das bei einem belebten Workspace. In diesem Fall erhalten Sie die Top-10.000 nach Click-Zählung und der Rest wird nicht zurückgegeben.

Das Feld total ist immer die Gesamtclicks über alle Gruppen, einschließlich aller nicht zurückgegebenen. Bei einem abgeschnittenen Ergebnis addieren sich die count-Werte also zu weniger als total — was bedeutet, dass ein als count / total berechneter Prozentsatz immer noch korrekt ist.

Wenn Sie den vollständigen Satz von Werten statt der Top-10.000 benötigen, exportieren Sie die Rohclick-Daten und aggregieren Sie diese selbst, oder verwenden Sie die BigQuery-Integration.

Echtzeitclick-Benachrichtigungen

Für Echtzeitclick-Benachrichtigungen siehe Webhooks. Webhooks senden eine POST-Anfrage an Ihre angegebene(n) URL(s) unmittelbar nach einem Click mit detaillierten Informationen zum Click.

Sie können auch Webhooks über die API verwalten - siehe die OpenAPI-Spezifikation für Details.

Richtlinie zur fairen Nutzung

Ratenlimits

Die Analytics API ist auf 50 Anfragen pro Stunde pro Workspace begrenzt.

Nutzungslimits

Zusätzlich zu Ratenlimits hat die Analytics API Nutzungslimits, die jeden Abrechnungszeitraum zurückgesetzt werden:

Was als Nutzung zählt

• API-Anfragen: Jeder Aufruf der Analytics API-Endpunkte (/clicks, /counters, /export) zählt als eine Anfrage.
• Gescannte Daten: Die Menge an Daten, die von unserer Analytics-Datenbank verarbeitet wird, um Ihre Anfrage zu erfüllen. Größere Datumsbereiche und komplexere Abfragen durchsuchen mehr Daten.

Was passiert, wenn Sie Ihre Limits überschreiten

Wenn Sie Ihre Nutzungslimits überschreiten:

1. 1
   API-Anfragen geben einen 429 Too Many Requests-Fehler zurück
2. 2
   Ihre Limits werden automatisch zu Beginn Ihres nächsten Abrechnungszeitraums zurückgesetzt
3. 3
   Ihre Links funktionieren weiterhin normal und verfolgen Clicks

Tipps zur Reduzierung der Nutzung

Die meisten Benutzer können alle ihre Daten in einer einzigen API-Anfrage abrufen mit Pivot-Modus (pivot=link_id), der alle Links' Verkehr als Matrix in einem Aufruf zurückgibt.

• Verwenden Sie Pivot-Modus: Fügen Sie pivot=link_id hinzu, um Verkehr für alle Links in einer einzelnen Anfrage zu erhalten, statt jeden Link separat abzufragen
• Zwischenspeichern Sie Antworten: Speichern Sie API-Antworten lokal, statt die gleichen Daten wiederholt abzurufen
• Verwenden Sie kleinere Datumsbereiche: Fragen Sie nur die Daten ab, die Sie benötigen
• Batch-Anfragen: Kombinieren Sie mehrere Link-Abfragen in einer einzelnen Anfrage mit dem link_ids-Parameter

Benötigen Sie mehr?

Wenn Sie höhere Limits benötigen, sprechen Sie bitte mit uns über das Support-Widget.

BigQuery-Integration

Für Hochvolumen-Analysebedarf bietet Linkly eine BigQuery-Integration, die direkten SQL-Zugriff auf Ihre Click-Daten bietet.

• Live-Datenzugriff - Fragen Sie Ihre Click-Daten direkt in BigQuery mit Echtzeit-Updates ab
• Unbegrenzte Abfragen - Keine API-Ratenlimits; Sie zahlen nur für BigQuery-Rechenleistung
• Benutzerdefinierte Berichte - Erstellen Sie Dashboards mit Looker, Data Studio oder Tableau
• Datenkonsolidierung - Verbinden Sie Click-Daten mit anderen Geschäftsmetriken

Die BigQuery-Integration ist im Enterprise-Plan enthalten. Kontaktieren Sie uns für Details.

Weitere Informationen zur BigQuery-Integration →

Verwandt

• Link-Verkürzungs-API - Erstellen und aktualisieren Sie Links programmatisch
• Webhooks - Echtzeitclick-Benachrichtigungen
• BigQuery-Integration - Direkter SQL-Zugriff auf Click-Daten
• Zapier-Integration - Codefreie Integrationen