Zum Hauptinhalt springen

Hilfe

Zeitplan & API-Zugang

Wann werden Daten aktualisiert?

Achtung.app sammelt und aktualisiert Daten automatisch. Erwartungswerte:

Frequenz Was aktualisiert wird
Täglich KI-Zitationsprüfungen, Scores, Wettbewerbsbenchmarks, Alerts, News-Monitoring
Wöchentlich SERP-Rankings, Wettbewerberprofile, Content-Vorschläge, KI-Strategie-Insights
Monatlich Keyword-Vorschläge, Keyword-Priorisierung, lokale Wettbewerber-Recherche, PDF-Reports

Alle täglichen Jobs sind morgens (Europe/Berlin) durch. Wer am Vormittag noch keine frischen Daten sieht, wartet am besten bis zur Mittagszeit, bevor er nachhakt.

API-Zugang (v1)

Eine stabile REST-API steht ab Pro und Enterprise zur Verfügung, um Marken-Daten in eigene Tools, BI-Dashboards oder Reports zu ziehen.

Authentifizierung

  1. In Einstellungen → API-Tokens im Admin-Panel öffnen.
  2. Token erstellen klicken, einen erkennbaren Namen vergeben und den Wert kopieren. Wir zeigen ihn nur einmal an.
  3. Bei jedem Request als Bearer-Token mitschicken:
Authorization: Bearer <dein-token>

Tokens haben standardmäßig die Berechtigung brand:read. Widerrufen lässt sich jeder Token jederzeit von derselben Seite; die nutzende Anwendung verliert sofort den Zugriff.

Endpunkte

Methode Pfad Liefert
GET /api/v1/brands Alle Marken im Team
GET /api/v1/brands/{id}/scores Monatliche GEO-Scores der Marke
GET /api/v1/brands/{id}/keywords Getrackte Keywords mit aktuellem Rang
GET /api/v1/brands/{id}/reports PDF-Reports mit signierten Download-URLs

Alle Antworten sind JSON. Fehler folgen dem Schema { "error": "<message>" } mit passendem HTTP-Status (401 unauthentifiziert, 403 Feature nicht im Plan, 404 Marke nicht gefunden, 429 gedrosselt).

Rate-Limits

  • 60 Requests pro Minute pro authentifiziertem Nutzer über alle v1-Endpunkte.
  • Separat: 3 Requests pro Stunde pro IP für das nicht-authentifizierte Free-Preview-Token-Endpoint POST /api/v1/tokens.

Gedrosselte Antworten enthalten den Standard-Header Retry-After.

Stabilitäts-Zusage

Der v1-Namespace ist stabil. Es werden nur Felder ergänzt, nie entfernt oder umbenannt. Breaking Changes erscheinen als v2 mit Deprecation-Fenster auf v1.

Basis-URL

https://achtung.app/api/v1

Tracking starten

Das Gleiche für deine Marke sehen?

Achtung.app misst täglich die KI-Sichtbarkeit beliebiger Marken. Kostenloser Check verfügbar, keine Kreditkarte nötig.

Kostenlos prüfen →

Suchst du die genaue Mess-Methodik? Siehe die Methodik-Seite.