Ihre Daten über die API lesen

Alles, was die Oberfläche zeigt, ist programmgesteuert lesbar, mit denselben Filtern und denselben Zeiträumen.

Kurz gesagt

Eine Lese-API stellt Ihre Statistiken im JSON-Format bereit, mit einem persönlichen Schlüssel. Sie dient dazu, ein internes Dashboard, einen automatisierten Bericht oder ein Fremdwerkzeug zu speisen.

Einen Schlüssel erhalten

Schlüssel werden in Ihrem Profil erstellt. Ein Schlüssel gewährt Lesezugriff auf alle Websites Ihres Kontos und kann jederzeit widerrufen werden.

Er wird im Autorisierungs-Header gesendet. Veröffentlichen Sie ihn nicht in Code, den ein Browser ausführt: dort könnte ihn jeder lesen.

Die Endpunkte

/api/v1/sites listet die zugänglichen Websites und ihre Kennungen.
/api/v1/stats liefert ein vollständiges Dashboard für eine Website und einen Zeitraum.
/api/v1/realtime liefert die aktiven Besucher.

Ein Aufruf liefert ein ganzes Dashboard, auch wenn Sie nur eine Kennzahl wollen. Die Rate ist gedeckelt: bündeln Sie Ihren Bedarf in einem Aufruf, statt sie zu vervielfachen.

Filtern

Filter werden als Parameter übergeben, in der Form filters[dimension]=wert. Die zulässigen Dimensionen stehen in der technischen Dokumentation.

Eine unbekannte Dimension wird stillschweigend ignoriert: die Antwort kommt vollständig zurück, ohne angewandten Filter und ohne Fehler. Prüfen Sie den genauen Namen der Dimension, wenn Ihre Zahlen zu hoch erscheinen.

Fehlt Ihnen eine Antwort? Schreiben Sie uns. Wir antworten selbst und ergänzen diesen Leitfaden.

Eine Frage stellen