ForHosting KIT · Entwickler-Tools

Wie viele Klicks hat mein Kurzlink? Zahlen live abrufen

Diese Funktion liefert die Nutzungszahlen eines zuvor erstellten Kurzlinks: die Gesamtzahl der Aufrufe, die zeitliche Verteilung und die grobe geografische Herkunft der Zugriffe, für alle, die wissen wollen, ob und wann ein geteilter Link tatsächlich genutzt wird, ohne ein eigenes Analyse-Werkzeug einzurichten.

● Stabilpro Anfrage + pro Link$0.002

Ausführen — $0.002 API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Welche Zahlen die Abfrage liefert

Die Abfrage zeigt die Gesamtzahl der Aufrufe seit der Erstellung des Kurzlinks, die Verteilung über Tage oder Wochen sowie eine grobe Einordnung nach Land, abgeleitet aus der IP-Adresse der zugreifenden Person. Einzelne Besucherinnen und Besucher lassen sich daraus nicht identifizieren, es handelt sich um zusammengefasste Zahlen, keine Einzelprotokolle mit persönlichen Daten.

Wofür sich die Zahlen eignen

Für eine Kampagne auf gedrucktem Material ist die Klickstatistik oft die einzige Möglichkeit zu erfahren, ob der Link überhaupt genutzt wird, da klassische Website-Statistiken erst nach dem Klick greifen. Eine Agentur erkennt so, welcher von mehreren Kurzlinks auf unterschiedlichen Flyern die meisten Zugriffe bringt, ohne dafür ein separates Analytics-Konto einrichten zu müssen.

Grenzen der Auswertung

Die Statistik zeigt Aufrufe des Kurzlinks, nicht das Verhalten auf der Zielseite nach der Weiterleitung; für eine Auswertung, was nach dem Klick auf der Website passiert, ist ein eigenes Analyse-Werkzeug auf der Zielseite selbst nötig. Zudem lassen sich Aufrufe durch automatisierte Systeme, etwa Vorschau-Funktionen mancher Messenger-Apps, nicht immer von echten Zugriffen unterscheiden.

Anwendungsfälle

Erfolg eines Flyers messen

Die Bäckerei Hoffmann e. K. aus Leipzig prüft nach einer Flyer-Aktion mit aufgedrucktem Kurzlink, wie viele Personen den Link tatsächlich aufgerufen haben, bevor die nächste Auflage gedruckt wird.

Vergleich zweier Kampagnenlinks

Eine Marketingagentur vergleicht die Klickzahlen zweier Kurzlinks aus derselben Kampagne, um zu erkennen, welcher Kanal – Postwurfsendung oder Schaufensteraushang – mehr Zugriffe gebracht hat.

Kontrolle nach dem Versand

Thomas Müller prüft einen Tag nach dem Versand eines Newsletters mit gekürztem Link, ob die Empfänger den Link überhaupt angeklickt haben.

Häufige Fragen

Was kostet eine Klickstatistik-Abfrage?

$0.002 pro Abfrage, unabhängig davon, wie viele Aufrufe der Kurzlink insgesamt hat.

Werden einzelne Besucher identifizierbar erfasst?

Nein. Erfasst werden zusammengefasste Zahlen zu Zeitpunkt und grober Herkunft, keine personenbezogenen Einzelprotokolle.

Wie aktuell sind die angezeigten Zahlen?

Sie umfassen alle Aufrufe bis zum Zeitpunkt der Abfrage; ein zeitgleicher Klick kann noch nicht enthalten sein.

Funktioniert die Statistik auch für sehr alte Kurzlinks?

Ja, solange der Kurzlink noch existiert, sind auch länger zurückliegende Aufrufe in der Statistik enthalten.

Brauche ich dafür ein Konto?

Nein, die Abfrage erfolgt direkt über die Kennung des Kurzlinks, ohne Registrierung.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/dev/short-url-stats

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/dev/short-url-stats \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/short-url-stats", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/short-url-stats",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/short-url-stats", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/short-url-stats", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "input": "…"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.short_url_stats",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →