Webanalyse-API für Entwickler

Fragen Sie Ihre Statistiken ab, verwalten Sie Websites und messen Sie eigene Ereignisse mit einer einfachen REST-API. Datenschutzfreundliche Analysedaten als sauberes JSON.

REST + JSONeinfache, vorhersehbare Endpunkte
BearerToken-Authentifizierung
120Anfragen pro Minute
v1stabile, versionierte API

API-Dokumentation entdecken

Drei Ressourcen decken alles ab, was Sie brauchen, um auf Ihren Analysedaten aufzubauen.

Statistik-API

Fragen Sie Seitenaufrufe, Besucher, Top-Seiten, Referrer, Länder, Städte, Geräte, Browser, Kampagnen und Ereignisse für jeden Zeitraum ab.

Statistik-API-Dokumentation lesen →

Websites-API

Websites auflisten, anlegen, ändern und löschen sowie Datenschutz, Bot-Filter und ausgeschlossene IPs oder URL-Parameter per Programm steuern.

Websites-API-Dokumentation lesen →

Ihre erste API-Anfrage in 3 Schritten

Kein SDK nötig. Jeder HTTP-Client funktioniert.

  1. Holen Sie sich Ihren API-Schlüssel

    Öffnen Sie Ihre Kontoeinstellungen und kopieren Sie Ihren persönlichen API-Schlüssel. Die API steht in Tarifen mit API-Zugang zur Verfügung.

  2. Anfrage senden

    Rufen Sie einen beliebigen Endpunkt auf, mit Ihrem Schlüssel als Bearer-Token im Authorization-Header.

  3. JSON-Antwort verwenden

    Jede Antwort ist JSON. Leiten Sie sie in Ihr eigenes Dashboard, Ihre Tabelle, Ihren Bericht oder Ihre Automatisierung weiter.

Beispiel: Top-Seiten einer Website

curl --location --request GET 'https://noralytic.com/api/v1/stats/{website_id}?name=page&from=2026-01-01&to=2026-01-31' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'

Ersetzen Sie {website_id} durch die ID Ihrer Website und {api_key} durch Ihren persönlichen API-Schlüssel.

API-Endpunkte im Überblick

Alle Endpunkte liegen unter https://noralytic.com/api/v1 und liefern JSON.

Liste der API-Endpunkte
MethodeEndpunktBeschreibung
GET /api/v1/stats/{website_id} Einen Statistikbericht abrufen, etwa Top-Seiten, Referrer oder Länder, für eine Website und einen Zeitraum.
GET /api/v1/websites Ihre Websites mit Suche, Sortierung und Seitenaufteilung auflisten.
POST /api/v1/websites Eine neue Website anlegen.
GET /api/v1/websites/{id} Eine einzelne Website abrufen.
PUT /api/v1/websites/{id} Eine Website ändern.
DELETE /api/v1/websites/{id} Eine Website samt Daten löschen.
GET /api/v1/account Das angemeldete Konto abrufen.
GET /api/v1/status Prüfen, ob die API erreichbar ist. Keine Authentifizierung nötig.

Statistikberichte (Parameter name) unterstützen: browser, campaign, city, continent, country, device, event, language, operating_system, page, pageview, referrer, screen_resolution, visitor.

Eigene Ereignisse mit JavaScript messen

Binden Sie das Tracking-Skript einmal ein und erfassen Sie dann Anmeldungen, Käufe oder jede andere Aktion mit einer einzigen Codezeile.

1. Tracking-Skript einbinden

<script data-host="https://noralytic.com" src="https://noralytic.com/js/script.js" id="ZwSg9rf6GA" async defer></script>

2. Ereignis messen

pa.track({ name: 'signup', value: 19.99, unit: 'EUR' });

Wert und Einheit sind optional. Ereignisnamen dürfen bis zu 64 Zeichen lang sein. Ereignisse enthalten nie personenbezogene Daten.

Was Sie mit der Analyse-API bauen können

Vom einzelnen internen Dashboard bis zum vollautomatischen Kunden-Reporting.

Eigene Dashboards

Zeigen Sie Live-Traffic-Zahlen in Ihrem eigenen Admin-Bereich, Kundenportal oder in internen Tools.

Berichte und Exporte

Übernehmen Sie Statistiken in Tabellen, BI-Tools oder geplante Kundenberichte, ganz ohne manuelle CSV-Downloads.

Agentur-Automatisierung

Legen Sie Websites für neue Kunden automatisch an und konfigurieren Sie sie als Teil Ihres Onboardings.

Benachrichtigungen und Integrationen

Lösen Sie Slack-Nachrichten, E-Mails oder Webhooks aus, wenn sich Ihr Traffic oder Ihre Kampagnenzahlen ändern.

Rate-Limits und Fehlercodes

Die API erlaubt bis zu 120 Anfragen pro Minute und Konto. Fehler werden als JSON mit Meldung und Statuscode zurückgegeben.

HTTP-Statuscodes
StatusBedeutung
200Die Anfrage war erfolgreich.
401Der API-Schlüssel fehlt oder ist ungültig.
403Ihr Tarif enthält keinen API-Zugang.
404Die Ressource wurde nicht gefunden.
429Zu viele Anfragen. Warten Sie einen Moment und versuchen Sie es erneut.

Häufige Fragen zur API

Schnelle Antworten zu Zugang, Authentifizierung und Limits.

Gibt es eine Webanalyse-API?

Ja. Noralytic bietet eine REST-API mit JSON-Antworten, mit der Sie Statistiken lesen, Websites verwalten und Kontodaten aus Ihrem eigenen Code abrufen können.

Welche Tarife enthalten API-Zugang?

API-Zugang ist in diesen Tarifen enthalten: Pro, Business. Anfragen von Konten ohne API-Zugang liefern einen 403-Fehler.

Wie authentifiziere ich API-Anfragen?

Senden Sie Ihren API-Schlüssel bei jeder Anfrage als Bearer-Token im Authorization-Header. Ihren Schlüssel finden und erneuern Sie in den Kontoeinstellungen.

Welche Rate-Limits gelten für die API?

Die API erlaubt bis zu 120 Anfragen pro Minute und Konto. Bei Überschreitung erhalten Sie eine 429-Antwort und können es nach kurzer Pause erneut versuchen.

Welche Statistiken kann ich abfragen?

Sie können abfragen: browser, campaign, city, continent, country, device, event, language, operating system, page, pageview, referrer, screen resolution, visitor. Jeder Bericht unterstützt Zeiträume, Suche, Sortierung und Seitenaufteilung.

Kann ich eigene Ereignisse aus meinem Code messen?

Ja. Rufen Sie pa.track() in JavaScript mit einem Ereignisnamen und optional einem Zahlenwert und einer Einheit auf. Ereignisse erscheinen in Ihrem Ereignisbericht und in der Statistik-API.

Respektiert die API die Privatsphäre der Besucher?

Ja. Die API liefert nur dieselben aggregierten, anonymen Statistiken, die Sie auch im Dashboard sehen. Noralytic speichert keine Cookies oder IP-Adressen, daher gibt es keine personenbezogenen Besucherdaten abzurufen.

Bauen Sie mit datenschutzfreundlichen Analysedaten

Erstellen Sie ein kostenloses Konto, wechseln Sie auf einen Tarif mit API-Zugang und holen Sie sich Ihren API-Schlüssel in wenigen Minuten.

Kostenlos starten Tarife mit API-Zugang ansehen