Mo. - Fr. 09:00 - 18:00

REST API

Ihre Daten gehören in das Dashboard, in dem Ihr Team bereits arbeitet. 7 Lese-Endpoints, einfaches JSON, kein SDK erforderlich.

Startseite /
Plattform /
REST API

In dreißig Sekunden zur ersten Antwort

Erstellen Sie einen Key im Dashboard unter API Keys und senden Sie ihn als Bearer-Token. Das ist die gesamte Einrichtung.

# Alle überwachten Keywords auflisten
curl -H "Authorization: Bearer sk_your_key_here" \
     "https://seo.newinterval.com/api/v1/keywords?project_id=3"

{
  "data": [
    {
      "id": 812,
      "keyword": "seo platform lebanon",
      "project_id": 3,
      "country": "LB",
      "location": "Beirut",
      "current_position": 4,
      "last_checked": "2026-07-30 06:12:03"
    }
  ],
  "meta": { "count": 1, "project_id": 3 }
}

Jede Antwort verwendet denselben Umschlag: Ergebnisse unter data, Kontext unter meta. Fehler kommen als {error, code, message} mit einem passenden HTTP-Status zurück. Mehr gibt es nicht zu lernen.

Die Endpoints

Alle GET. Alle auf das beschränkt, was der Benutzer des Keys sehen darf — ein Key, der für jemanden mit Zugriff auf ein Projekt ausgestellt wurde, kann kein anderes lesen.

Endpoint	Gibt zurück	Filter
`/api/v1/`	Der Endpoint-Index — nützlich als Verbindungstest.	—
`/api/v1/projects`	Projekte, auf die der Benutzer des Keys Zugriff hat.	—
`/api/v1/keywords`	Überwachte Keywords mit ihren aktuellen Positionen.	project_id, status, search
`/api/v1/positions`	Vollständiger Ranking-Verlauf für ein Keyword.	keyword_id, from, to
`/api/v1/gsc`	Search-Console-Klicks, Impressionen und Positionen.	project_id, period_days
`/api/v1/alerts`	Aktuelle Alerts.	unread
`/api/v1/credits`	Aktuelles Guthaben plus die zehn letzten Protokolleinträge.	—

Bewusst nur lesend. Die API liest Ihre Daten; sie erstellt keine Projekte, fügt keine Keywords hinzu und löst keine Prüfungen aus. Alles, was Credits verbraucht, geschieht im Dashboard, wo Sie sehen können, was es kosten wird. Schreib-Endpoints stehen auf der Roadmap, nicht im Produkt — bauen Sie also noch nicht darauf auf.

Keys, Limits und gutes Verhalten

Einmal angezeigt, dann gehasht

Der vollständige Key wird genau einmal angezeigt — bei der Erstellung. Danach werden nur die ersten Zeichen dargestellt. Wir speichern einen Key-basierten Hash, nie den Key selbst — so gibt ein Datenbank-Leak niemandem Ihren API-Zugang.

1.000 Anfragen pro Stunde

Pro Key, serverseitig gezählt. Jede Antwort enthält X-RateLimit-Limit und X-RateLimit-Remaining, damit Sie vor dem Limit bremsen können, nicht danach.

Ablauf und Widerruf

Geben Sie einem Key bei der Erstellung ein Ablaufdatum oder widerrufen Sie ihn sofort. Erstellen Sie einen Key pro Integration, und Sie können bei Bedarf genau eine Sache abschalten.

API-Lesezugriffe kosten nichts

Das Lesen bereits erhobener Daten verbraucht keine Credits. Fragen Sie so oft ab, wie das Rate-Limit erlaubt.

Authentifizierung

Senden Sie den Key als Bearer-Token:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Falls Ihr Client keine Header setzen kann, funktioniert ein ?token=-Query-Parameter als Fallback — bevorzugen Sie aber den Header, da Query-Strings in Server-Logs und dem Browser-Verlauf landen.

Verfügbarkeit

API-Zugang ist in den Plänen Agency und Network enthalten. Zum Vergleich.

Jetzt integrieren

Starten Sie mit Agency, erstellen Sie einen Key und haben Sie Ihre Rankings noch am selben Nachmittag in Ihrem eigenen Dashboard.

Agency starten Alle Pläne ansehen

Kundenportal

Kontakt