Rank Tracker-API

Einleitung

Die Ranking-Verfolgung wird zu einer ganz anderen Herausforderung, wenn Sie Hunderte von Websites, Tausende von Keywords oder SEO-Berichte verwalten, die automatisch aktualisiert werden müssen.

Sich in ein Dashboard einzuloggen und Daten manuell zu exportieren, mag bei kleineren Projekten noch funktionieren. Bei großem Umfang wird dies jedoch schnell zu einem Engpass.

Deshalb haben wir die Ranktracker-APIentwickelt.

Die Ranktracker-API ist nun verfügbar und bietet Entwicklern, SEO-Teams, Agenturen, SaaS-Unternehmen und Datenteams programmatischen Zugriff auf ihre Ranktracker-Daten.

Mit der API können Sie:

• Rufen Sie die Top-100-Keyword-Rankings ab
• Greifen Sie auf SERP-Daten zu
• AI-Übersichten und andere SERP-Funktionen erkennen
• Domains erstellen und verwalten
• Keywords hinzufügen und verwalten
• Konkurrenten verfolgen
• Auf den Ranking-Verlauf zugreifen
• Share of Voice berechnen
• Schlüsselwörter mithilfe von Tags organisieren
• Nutzung und Kontingente des Kontos überwachen
• Automatisierte SEO-Berichtspipelines erstellen
• Ranking-Daten mit internen Anwendungen und Dashboards verknüpfen

Anstatt SEO-Daten manuell zwischen Plattformen zu übertragen, ermöglicht die Ranktracker-API Ihrer eigenen Software, direkt mit der Ranking-Infrastruktur hinter Ranktracker zu arbeiten.

API-Schlüssel erstellen oder verwalten: https://app.ranktracker.com/account/api

Lesen Sie die API-Dokumentation: https://developers.ranktracker.com/

Was ist die Ranktracker-API?

Die Ranktracker-API ist eine REST-API, die programmatischen Zugriff auf Ihr Ranktracker-Konto ermöglicht.

Anstatt Ranktracker jedes Mal zu öffnen, wenn Sie Ranking-Informationen benötigen, kann Ihre Anwendung die Daten automatisch abrufen.

Die API basiert auf denselben Kernressourcen, die auch in Ranktracker verwendet werden:

• Konten
• Domains
• Suchbegriffe
• Wettbewerber
• Ranking-Verlauf
• SERP-Daten
• Share of Voice
• Tags
• Nutzung und Kontingent

Dies ermöglicht es Entwicklern, sowohl Ranktracker-Daten abzurufen als auch zu steuern, was Ranktracker verfolgt.

Beispielsweise könnte eine SEO-Agentur automatisch ein Ranktracker-Projekt anlegen, sobald ein neuer Kunde in ihr CRM aufgenommen wird, die Keywords und Mitbewerber des Kunden hinzufügen und anschließend deren Rankings in ein internes Reporting-Dashboard einspeisen.

Eine SaaS-Plattform könnte dieselbe API nutzen, um Ranking-Daten direkt in ihrem eigenen Produkt anzuzeigen.

Ein Datenteam könnte tägliche Rankings automatisch an BigQuery, Snowflake, PostgreSQL, Google Sheets oder ein anderes Data Warehouse zur weiteren Analyse senden.

Einen Überblick darüber, wie die Ressourcen zusammenpassen, finden Sie im Leitfaden „Ranktracker API Core Concepts“.

Standardmäßig Top-100-Rankings

Einer der größten Vorteile der Ranktracker-API ist die Tiefe der Ranking-Daten.

Jede Keyword-Analyse umfasst standardmäßig die Top-100-Ergebnisse bei Google.

Das bedeutet, dass Sie alle 10 Seiten der Suchergebnisse analysieren können, anstatt nur zu sehen, was derzeit auf Seite eins rangiert.

Das ist wichtig, da der SEO-Fortschritt in der Regel schon lange vor dem Erreichen der Top 10 durch ein Keyword beginnt.

Ein Keyword könnte sich wie folgt bewegen:

Platz 91 → Platz 63 → Platz 37 → Platz 18 → Platz 9

Das stellt einen erheblichen SEO-Fortschritt dar.

Wenn Ihre Ranking-Daten bei den ersten 10 Ergebnissen enden, bleibt fast der gesamte Verlauf unsichtbar.

Mit dem Top-100-Tracking können Sie Folgendes überwachen:

• Neue Rankings, die in die Google-Top-100 aufsteigen
• Keywords, die sich in Richtung Seite eins bewegen
• Große Ranking-Gewinne und -Verluste
• Bewegungen bei den Mitbewerbern
• Sichtbarkeit bei Long-Tail-Suchanfragen
• Leistung neuer Inhalte
• Programmatische SEO-Kampagnen
• Umfangreiche Keyword-Portfolios

Dadurch eignet sich die API sowohl für übergreifende SEO-Berichte als auch für detaillierte Ranking-Analysen.

Erfahren Sie mehr über die API:

https://developers.ranktracker.com/

Rankings an über 107.000 Standorten verfolgen

Suchergebnisse variieren erheblich je nachdem, wo eine Suche durchgeführt wird.

Ranktracker unterstützt über 107.000 Standorte und ermöglicht es Teams, die lokale, nationale und internationale Sichtbarkeit in Suchmaschinen über die API zu verfolgen.

Die Keyword-Verfolgung kann unter Berücksichtigung verschiedener Faktoren konfiguriert werden, darunter:

• Suchmaschine
• Standort
• Sprache
• Gerät

Beispielsweise könnte dasselbe Keyword separat überwacht werden für:

• Vereinigte Staaten – Desktop
• Vereinigte Staaten – Mobilgerät
• Vereinigtes Königreich – Desktop
• Deutschland – Mobil
• Polen – Desktop

Jede Konfiguration kann als eigenständiges, überwachtes Keyword behandelt werden.

Dies ist besonders nützlich für:

• Internationale Suchmaschinenoptimierung
• Unternehmen mit mehreren Standorten
• Lokale SEO-Agenturen
• E-Commerce-Unternehmen
• Verlage, die in verschiedenen Märkten tätig sind
• SaaS-Unternehmen, die mehrere Länder ansprechen
• SEO-Teams in Großunternehmen

Anstatt ein Keyword als ein Keyword mit einer einzigen universellen Ranking-Position zu betrachten, können Sie analysieren, wie sich die Sichtbarkeit über verschiedene Märkte und Geräte hinweg verändert.

Ranking-Tracking für Desktop und Mobilgeräte

Suchergebnisse auf dem Desktop und auf Mobilgeräten können sich unterscheiden.

Ranktracker ermöglicht daher eine Segmentierung der Keyword-Verfolgung nach Geräten.

Das bedeutet, dass eine Integration Folgendes separat analysieren kann:

• Desktop-Rankings
• Mobile-Rankings

Beispielsweise kann eine Seite auf dem Desktop ein hohes Ranking erzielen, auf Mobilgeräten jedoch aufgrund von Unterschieden im SERP-Layout, bei lokalen Ergebnissen oder anderen Suchfunktionen eine andere Leistung zeigen.

Durch die Trennung dieser Datensätze erhalten SEO-Teams ein viel klareres Bild davon, wie Nutzer ihre Websites in der Suche tatsächlich vorfinden.

Die API ermöglicht zudem eine Gerätesegmentierung bei der Arbeit mit Funktionen wie „Share of Voice“.

Übersicht über SERP-Funktionen und KI-Erkennung

Moderne Google-Suchergebnisse enthalten weit mehr als herkömmliche organische Einträge.

SERPs können Folgendes enthalten:

• KI-Übersichten
• Featured Snippets
• Karten
• Lokale Ergebnisse
• Videos
• Einkaufsergebnisse
• Häufig gestellte Fragen
• Weitere Suchfunktionen

Die Ranktracker-API umfasst neben Keyword-Daten auch Informationen zu SERP-Funktionen und die Erkennung von KI-Übersichten.

Das bedeutet, dass Ihre Integration nicht nur analysieren kann, wo eine Website rangiert, sondern auch, was dieses Ranking bei Google umgibt.

Beispielsweise könnten Sie Folgendes identifizieren:

• Schlüsselwörter, die eine KI-Übersicht auslösen
• SERPs mit Featured Snippets
• Suchanfragen, bei denen Videoergebnisse überwiegen
• Suchbegriffe, die lokale Ergebnisse oder Kartenanzeigen liefern
• Veränderungen in der Zusammensetzung der SERPs im Zeitverlauf

Dies wird immer wichtiger, da die organische Position allein nicht immer das ganze Bild widerspiegelt.

Eine Seite, die auf einer herkömmlichen SERP an dritter Stelle steht, und eine Seite, die an dritter Stelle unterhalb einer KI-Übersicht, eines Kartenpakets, von Videos und „People Also Ask“ rangiert, können sehr unterschiedliche Sichtbarkeitsgrade aufweisen.

Die API ermöglicht es, diese Unterschiede in Ihre SEO-Analyse einzubeziehen.

Die vollständige API-Dokumentation finden Sie hier:

https://developers.ranktracker.com/

Zugriff auf vollständige SERP-Daten

Ranktracker bietet weit mehr als nur eine einzige Ranking-Zahl.

Für die verfolgten Keywords kann die API die neuesten Suchergebnisse zusammen mit den zugehörigen SERP-Informationen bereitstellen.

Die Struktur der API-Ressourcen umfasst:

• Aktuelle SERP-Daten
• Ranking-Informationen
• SERP-Funktionen
• Zwischengespeicherter SERP-HTML-Code

Das bedeutet, dass Entwickler Workflows auf der Grundlage der tatsächlichen Suchergebnisse erstellen können, anstatt lediglich etwas wie Folgendes zu speichern:

Position: 12

Für erfahrene SEO-Teams bietet dies deutlich mehr Flexibilität.

Sie könnten SERP-Informationen nutzen, um:

• Konkurrierende URLs analysieren
• Unerwartete Ranking-Veränderungen untersuchen
• Änderungen am Layout der Suchergebnisse identifizieren
• Interne SERP-Analyse-Tools erstellen
• Speichern historischer SERP-Informationen
• Suchresultatdaten in andere Modelle oder Analysesysteme einspeisen

Die vollständige Endpunkt-Referenz finden Sie hier:

https://developers.ranktracker.com/rest-api/

Domains über die API verwalten

Domains gehören zu den zentralen Ressourcen der Ranktracker-API.

Die REST-API ermöglicht Ihnen Folgendes:

• Domains erstellen
• Domains abrufen
• Domains aktualisieren
• Domains löschen

Eine Domain steht für eine Website, die in Ranktracker verfolgt wird.

Jede Domain kann dann Folgendes enthalten:

• Schlüsselwörter
• Konkurrenten
• Ranking-Verlauf
• Share-of-Voice-Daten

Dies ermöglicht ein automatisiertes Onboarding.

Beispielsweise könnte eine Agentur den folgenden Workflow erstellen:

Neuer Kunde meldet sich an
        ↓
Ranktracker-Domain erstellen
        ↓
Kunden-Keywords hinzufügen
        ↓
Konkurrenten hinzufügen
        ↓
Rank-Tracking starten
        ↓
Daten an das Reporting-Dashboard senden

Es ist nicht erforderlich, dass ein Teammitglied jedes neue Projekt manuell konfiguriert.

Eine vollständige Anleitung finden Sie im Tutorial „Domain hinzufügen und Keywords verfolgen“.

Suchbegriffe programmgesteuert hinzufügen und verwalten

Sobald eine Domain angelegt ist, können Suchbegriffe über die API verwaltet werden.

Sie können die API nutzen, um nachverfolgte Suchbegriffe hinzuzufügen und dabei die zugehörige Suchkonfiguration festzulegen.

Die Daten zu den nachverfolgten Suchbegriffen können folgende Faktoren umfassen:

• Wort
• Suchmaschine
• Standort
• Sprache
• Gerät
• Ranking-Ergebnisse

Sie können auch den Tracking-Lebenszyklus bestehender Keywords verwalten.

Dazu gehört die Möglichkeit,

• Suchbegriffe abrufen
• Ranking-Informationen anzeigen
• Tracking pausieren
• Tracking fortsetzen
• Tracking beenden
• Auf SERP-Informationen zugreifen
• Tags zuweisen

Dadurch kann Ihre eigene Anwendung steuern, welche Suchbegriffe Ranktracker überwacht.

Massen-Keyword-Tracking

Bei großen SEO-Konten sollte es nicht erforderlich sein, für jedes Keyword eine separate API-Anfrage zu stellen.

Ranktracker unterstützt Massenoperationen für Keywords.

Der Endpunkt zur Keyword-Erstellung akzeptiert eine Konfiguration aus „Wörter × Suchmaschinen“, wodurch viele Kombinationen aus überwachten Keywords in einer einzigen Anfrage erstellt werden können.

Stellen Sie sich zum Beispiel vor, Sie möchten Folgendes überwachen:

• 100 Keywords
• US-Desktop
• US-Mobilgeräte

Diese Konfigurationen können 200 zu verfolgende Keyword-Kombinationen erzeugen, ohne dass 200 einzelne Einrichtungsanfragen erforderlich sind.

Massenoperationen sind besonders nützlich für:

• Agenturen
• Unternehmens-SEO
• Große E-Commerce-Shops
• Programmatisches SEO
• SaaS-SEO-Plattformen
• Große Content-Anbieter

Ranktracker unterstützt außerdem das Tagging von Keywords in großen Mengen.

Lesen Sie den vollständigen Leitfaden zu Massenoperationen:

https://developers.ranktracker.com/guides/bulk-operations/

SEO-Konkurrenten verfolgen

Rankings werden wesentlich aussagekräftiger, wenn sie den Kontext der Konkurrenz berücksichtigen.

Die Ranktracker-API ermöglicht es, Wettbewerber im Vergleich zu den überwachten Domains zu verwalten.

Dadurch lässt sich Ihre Suchleistung automatisch im Vergleich zu konkurrierenden Websites analysieren.

Sie können die Daten der Wettbewerber nutzen, um Folgendes zu überwachen:

• Welche Wettbewerber gewinnen an Sichtbarkeit?
• Welche Websites überholen Ihre Domain
• Veränderungen in gemeinsamen Keyword-Gruppen
• Ranking-Trends der Konkurrenz
• Relative Sichtbarkeit in den Suchergebnissen
• Veränderungen beim Share of Voice

Für Agenturen kann dies Teil eines automatisierten Kundenberichtssystems werden.

Anstatt einen Kunden jeden Monat manuell mit Wettbewerbern zu vergleichen, können die relevanten Daten direkt in die Berichts-Pipeline integriert werden.

Zugriff auf historische Ranking-Daten

Aktuelle Rankings zeigen nur, was gerade passiert.

Historische Ranking-Daten zeigen, in welche Richtung sich die SEO-Leistung entwickelt.

Ranktracker stellt über die API den Verlauf der Domain-Rankings zur Verfügung, sodass Entwickler die Sichtbarkeit im Zeitverlauf analysieren können.

Anhand historischer Daten lässt sich Folgendes ermitteln:

• Ranking-Gewinne
• Ranking-Einbußen
• Sichtbarkeitstrends
• Entwicklung der Keywords
• Veränderungen nach SEO-Kampagnen
• Auswirkungen von Google-Updates
• Langfristige Kampagnenleistung

Sie können den Ranking-Verlauf auch nutzen, um benutzerdefinierte Diagramme und Dashboards zu erstellen.

Beispiel:

Ranktracker-API
       ↓
Tägliche Ranking-Erfassung
       ↓
Data Warehouse
       ↓
Historischer SEO-Datensatz
       ↓
Dashboard / Benachrichtigungen / Analyse

Ranktracker bietet ein spezielles Tutorial, das zeigt, wie man tägliche Rankings in ein Data Warehouse überträgt:

https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Ranktracker-Daten an ein Data Warehouse senden

Einer der nützlichsten API-Workflows ist die automatische Speicherung von Ranktracker-Daten in Ihrer eigenen Datenbank oder Ihrem eigenen Data Warehouse.

Beispielsweise könnten Ranking-Daten an folgende Ziele gesendet werden:

• BigQuery
• Snowflake
• PostgreSQL
• MySQL
• Google Tabellen
• Interne Analysedatenbanken

Diese Informationen können dann mit anderen Geschäftsdaten kombiniert werden.

Beispiel:

Ranktracker
     ↓
Ranktracker-API
     ↓
Data Warehouse
     ↓
Google Search Console
Analytics
Conversions
Umsatz
CRM-Daten
     ↓
Business-Intelligence-Dashboard

Dadurch entsteht ein wesentlich umfassenderes Bild der SEO-Leistung.

Anstatt nur zu wissen, dass ein Keyword von Position 8 auf Position 3 geklettert ist, könnten Sie analysieren, ob die Veränderung auch zu folgenden Effekten geführt hat:

• Mehr organische Klicks
• Mehr Leads
• Höhere Konversionsraten
• Höhere Umsätze

Das Tutorial „Rankings to Warehouse“ bietet ein Beispiel für den Aufbau einer solchen Pipeline.

Erstellen von Share-of-Voice-Berichten

Die Ranktracker-API stellt auch „Share of Voice“-Daten bereit.

„Share of Voice“ liefert eine umfassendere Messgröße dafür, wie sichtbar eine Domain über eine Reihe von nachverfolgten Keywords hinweg ist.

Anstatt zu fragen:

Wo rangieren wir bei diesem Suchbegriff?

können Sie fragen:

Wie sichtbar sind wir auf dem gesamten Suchmaschinenmarkt?

Dies ist besonders aussagekräftig, wenn Daten von Mitbewerbern einbezogen werden.

Die Share-of-Voice-API kann zur Analyse folgender Aspekte verwendet werden:

• Ihre allgemeine Sichtbarkeit
• Sichtbarkeit der Wettbewerber
• Veränderungen der Sichtbarkeit im Zeitverlauf
• Relative Marktposition
• Sichtbarkeit auf dem Desktop
• Sichtbarkeit auf Mobilgeräten

Der Endpunkt unterstützt Datumsbereiche und Gerätesegmentierung, sodass der Share of Voice in benutzerdefinierte SEO-Berichte integriert werden kann.

Ein vollständiges Implementierungsbeispiel finden Sie hier:

https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Keywords mit Tags organisieren

Große Keyword-Portfolios lassen sich ohne eine klare Struktur nur schwer verwalten.

Ranktracker bietet Tags auf Kontoebene, die den verfolgten Keywords zugeordnet werden können.

Sie könnten Tags erstellen für:

• Produktkategorien
• Suchabsicht
• Standorte
• Inhaltstypen
• Kampagnen
• Kunden
• Trichterphasen
• Geschäftsbereiche
• SEO-Teams

Zum Beispiel:

„Laufschuhe kaufen“ → Kommerziell
„beste Laufschuhe“ → Vergleich
„So reinigt man Laufschuhe“ → Informativ

Die gleichen Tags können über verschiedene Domains und Keyword-Gruppen hinweg wiederverwendet werden.

Ranktracker bietet außerdem die Möglichkeit der Massen-Tagging, sodass große Gruppen von Keywords organisiert werden können, ohne dass einzelne Anfragen erforderlich sind.

Ein spezielles Tutorial finden Sie hier:

https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Nutzung und Kontingent des Kontos überwachen

Automatisierte Systeme müssen zudem die ihnen zur Verfügung stehenden Kontoressourcen kennen.

Die Ranktracker-API bietet:

GET /v1/account/usage

Dieser Endpunkt meldet die Kontoauslastung und die Limits.

Aktuelle Nutzungsinformationen können Folgendes umfassen:

• API-Zugriffsstatus
• Schlüsselwörter
• Datenzeilen
• Nutzung auf Abruf
• Nutzung des SERP-Analysators

Jede Quote kann Werte wie die folgenden liefern:

• Nutzung
• Limit
• Verbleibend

Dadurch kann eine Anwendung vor dem Start eines umfangreichen Vorgangs die verfügbare Kapazität prüfen.

Beispielsweise kann Ihr System vor dem Importieren von Tausenden von Keywords die Kontoauslastung abfragen und ermitteln, wie viel Kapazität noch verfügbar ist.

Lesen Sie den vollständigen Leitfaden:

https://developers.ranktracker.com/guides/usage-and-quota/

So funktioniert die Authentifizierung bei der Ranktracker-API

Ranktracker-REST-API-Anfragen werden mithilfe eines API-Schlüssels authentifiziert.

Sie können Ihre Schlüssel direkt in Ranktracker erstellen und verwalten:

https://app.ranktracker.com/account/api

Behandeln Sie Ihren API-Schlüssel stets wie ein Passwort.

Die Basis-URL der Produktions-API lautet:

https://api.ranktracker.com

Die API-Ressourcen befinden sich unter dem Pfad /v1.

Beispiel:

https://api.ranktracker.com/v1/domains

Der API-Schlüssel wird direkt im „Authorization “-Header übermittelt.

Bei Standard-REST-API-Anfragen gibt es kein „Bearer“-Präfix.

Beispiel:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

Ein Ranktracker-API-Schlüssel sollte serverseitig gespeichert werden und darf niemals über folgende Wege offengelegt werden:

• Browser-JavaScript
• Frontend-Quellcode
• Öffentliche Repositorys
• Code für mobile Anwendungen
• Öffentliche Konfigurationsdateien

Weitere Informationen finden Sie hier:

Schnellstart: https://developers.ranktracker.com/guides/quickstart/

Authentifizierung: https://developers.ranktracker.com/guides/authentication/

API-Schlüssel erstellen/verwalten: https://app.ranktracker.com/account/api

Struktur der API-Ressourcen

Ranktracker verwendet UUIDs zur Identifizierung von Ressourcen.

Dazu gehören Ressourcen wie:

• Domains
• Schlüsselwörter
• Wettbewerber
• Tags

Eine vereinfachte Darstellung sieht wie folgt aus:

Konto
│
├── Nutzung
├── Tags
│
└── Domains
    │
    ├── Ranking-Verlauf
    ├── Share of Voice
    ├── Wettbewerber
    │
    └── Keywords
        │
        ├── SERP
        ├── Zwischengespeicherter SERP-HTML-Code
        └── Tags

Dadurch ist die Struktur der API vorhersehbar.

Eine Domain verfügt über Keywords und Wettbewerber.

Ein Schlüsselwort gehört zu einer überwachten Domain und verfügt über zugehörige SERP- und Ranking-Informationen.

Tags existieren auf Kontoebene und können mit Suchbegriffen verknüpft werden.

Weiterlesen:

https://developers.ranktracker.com/guides/concepts/

JSON-API-Antworten

Ranktracker-Antworten verwenden ein einheitliches JSON:API-Format.

Die Ressource wird unter „data“ zurückgegeben, während ihre Felder unter „attributes“ gespeichert sind.

Beispiel:

{
  "data": {
    "id": "DOMAIN_UUID",
    "type": "domain",
    "attributes": {
      "host": "www.example.com",
      "projectName": "Beispiel",
      "matchType": "any"
    }
  }
}

Entwickler sollten außerdem eine wichtige Namenskonvention beachten:

• API-Antworten verwenden „camelCase“
• Bei Schreibanfragen wird „snake_case“ verwendet

Eine Antwort könnte beispielsweise Folgendes enthalten:

projectName

während eine Schreibanfrage Folgendes verwendet:

project_name

Diese Konvention gilt für die gesamte API.

Siehe:

https://developers.ranktracker.com/guides/concepts/

Paginierung

Listen-Endpunkte sind paginiert, damit Anwendungen effizient mit großen Ranktracker-Konten arbeiten können.

Die Paginierung gilt für Ressourcen, darunter:

• Domänen
• Schlüsselwörter
• Wettbewerber
• Tags

Die beiden wichtigsten Parameter sind:

• Seite
• pro_Seite

per_page unterstützt bis zu 1.000 Datensätze pro Seite.

Informationen zur Paginierung werden über Antwort-Header zurückgegeben, darunter:

• X-Gesamtanzahl
• X-Gesamtseiten
• X-Seiten pro Seite
• X-Aktuelle-Seite

Bei umfangreichen Exporten können Anwendungen daher so lange Seiten anfordern, bis der gesamte Datensatz abgerufen wurde.

Lesen Sie den Leitfaden zur Paginierung:

https://developers.ranktracker.com/guides/pagination/

Fehlerbehandlung und Ratenbegrenzungen

Die Ranktracker-API verwendet Standard-HTTP-Statuscodes, um die programmatische Behandlung von Fehlern zu vereinfachen.

Zu den gängigen Antworten gehören:

Status	Bedeutung	Beispiel
400	Ungültige Anfrage	Ein erforderlicher Parameter fehlt oder ist fehlerhaft
402	Kontingent überschritten	Der angeforderte Vorgang würde das Kontingent des Kontos überschreiten
403	Nicht zulässig	Die Anfrage ist nicht autorisiert oder der API-Zugriff ist nicht verfügbar
404	Nicht gefunden	Die Ressource ist in diesem Konto nicht vorhanden
422	Validierungsfehler	Die Anfrage ist gültiges JSON, enthält jedoch ungültige Daten
429	Zu viele Anfragen	Die Integration unterliegt einer Ratenbegrenzung

Wenn eine 429 -Antwort auftritt, sollten Integrationen die zurückgegebenen „Retry-After“-Angaben beachten, bevor sie einen erneuten Versuch unternehmen.

Dadurch können Produktionsanwendungen vorübergehende Drosselungen bewältigen, ohne einfach abzubrechen.

Die vollständige Dokumentation zu Fehlern und Ratenbegrenzungen finden Sie hier:

https://developers.ranktracker.com/guides/errors-and-rate-limits/

Ranktracker-REST-API vs. MCP

Die REST-API ist nicht die einzige Möglichkeit, externe Software mit Ranktracker zu verbinden.

Ranktracker stellt außerdem einen gehosteten MCP-Server zur Verfügung.

MCP steht für „Model Context Protocol“ und ermöglicht es kompatiblen KI-Anwendungen und -Agenten, direkt mit Ranktracker-Daten zu arbeiten.

Dazu gehören kompatible Clients wie beispielsweise:

• ChatGPT
• Claude
• Cursor
• Andere MCP-kompatible KI-Anwendungen

REST und MCP greifen auf dieselben zugrunde liegenden Ranktracker-Daten zu, sind jedoch für unterschiedliche Arbeitsabläufe konzipiert.

	Ranktracker-REST-API	Ranktracker MCP
Am besten geeignet für	Anwendungen, Dashboards, Data Warehouses und geplante Jobs	KI-Assistenten und -Agenten
Aufrufer	Ihr Backend oder HTTP-Client	ChatGPT, Claude, Cursor oder ein anderer MCP-Client
Schnittstelle	REST-Endpunkte	MCP-Tools
REST-Pfad	/v1/...	/mcp
Typische Verwendung	Automatisches Verschieben und Verwalten von SEO-Daten	Interaktive Erkundung von SEO-Daten

REST ist beispielsweise die bessere Wahl, wenn Sie Folgendes tun möchten:

• Rankings jede Nacht exportieren
• Ein BI-Dashboard aktualisieren
• SEO-Projekte automatisch erstellen
• Fügen Sie Keywords aus Ihrer Anwendung hinzu
• Ranking-Daten mit einer Datenbank synchronisieren

MCP eignet sich besser für Fragen wie:

Welches meiner erfassten Keywords hat diese Woche am stärksten an Position verloren?

oder:

Welche Wettbewerber haben am meisten an Sichtbarkeit gewonnen?

Ein KI-Client kann das geeignete Ranktracker-Tool auswählen und die relevanten Daten abfragen.

Viele erfahrene SEO-Teams können beide nutzen.

REST kümmert sich um Infrastruktur und Automatisierung. MCP stellt Ranktracker-Daten für KI-Agenten bereit.

Erfahren Sie mehr:

MCP-Übersicht: https://developers.ranktracker.com/mcp/

Einen MCP-Client verbinden: https://developers.ranktracker.com/mcp/connect/

MCP-Tool-Referenz: https://developers.ranktracker.com/mcp/tools/

Was lässt sich mit der Ranktracker-API erstellen?

Die Ranktracker-API kann für weit mehr als nur die Anzeige einer Keyword-Position genutzt werden.

Hier sind einige der nützlichsten Anwendungsmöglichkeiten.

Automatisierte SEO-Berichterstellung

Eine Agentur kann Ranking-Informationen automatisch in ihre eigene Berichtsplattform einbinden.

Anstatt:

Ranktracker öffnen
↓
CSV exportieren
↓
Tabelle bearbeiten
↓
Bericht hochladen
↓
An Kunden senden

können Sie Folgendes einrichten:

Ranktracker-API
↓
Berichtsplattform
↓
Automatisch aktualisierter Kundenbericht

Dies ist besonders wertvoll für Agenturen, die eine große Anzahl von Kunden betreuen.

Maßgeschneiderte SEO-Dashboards

Möglicherweise nutzt Ihr Unternehmen bereits eine interne Berichts- oder Business-Intelligence-Plattform.

Über die API können Ranktracker-Daten als weitere Datenquelle in diese Umgebung integriert werden.

Sie könnten Dashboards erstellen, die Folgendes anzeigen:

• Keyword-Rankings
• Ranking-Veränderungen
• Top-3-Keywords
• Top-10-Keywords
• Top-100-Keywords
• Share of Voice
• Sichtbarkeit der Wettbewerber
• SERP-Funktionen
• Erscheinungen in der KI-Übersicht

Das daraus resultierende Dashboard lässt sich speziell auf die Berichtsanforderungen Ihres Unternehmens zuschneiden.

Automatisierte Kunden-Onboarding-Prozesse

SEO-Agenturen können Ranktracker in ihren Kunden-Onboarding-Prozess integrieren.

Beispiel:

Kunde kauft SEO-Paket
↓
CRM legt Kunden an
↓
Ranktracker-API legt Domain an
↓
Keywords werden hinzugefügt
↓
Konkurrenten werden hinzugefügt
↓
Tracking beginnt

Dadurch entfällt die wiederkehrende manuelle Projekteinrichtung.

SEO-Data-Warehouses

Rankings gewinnen an Wert, wenn sie mit anderen Marketing- und Geschäftsdaten verknüpft werden.

Ranktracker-Informationen lassen sich kombinieren mit:

• Google Search Console
• Analytics
• CRM-Daten
• Conversion-Daten
• E-Commerce-Umsatz
• Lead-Daten
• Performance der Inhalte

Dies kann dabei helfen, weitaus wichtigere Fragen zu beantworten, als nur ein Ranking zu überprüfen.

Zum Beispiel:

Welche Ranking-Verbesserungen haben den größten Umsatz generiert?

oder:

Welche Keyword-Gruppen steigern die Sichtbarkeit, generieren aber keine Conversions?

Ranking-Benachrichtigungen

Historische Ranking-Daten können auch benutzerdefinierte Benachrichtigungssysteme antreiben.

Eine Integration könnte automatisch erkennen, wenn:

• Ein Keyword fällt aus den Top 3 heraus
• Eine Seite steigt in die Top 10 auf
• Ein Suchbegriff rückt in die Top 100 vor
• Ein wichtiges Keyword verschwindet aus den Top 100
• Ein Mitbewerber überholt Ihre Website
• Die Sichtbarkeit in den Suchergebnissen sinkt stark

Benachrichtigungen könnten dann an Ihre eigene E-Mail-Adresse, an Slack, an ein internes Dashboard oder an Ihr Überwachungssystem gesendet werden.

Wettbewerbsanalyse

Die Kombination von:

• Rankings
• Konkurrenzbeobachtung
• Ranking-Verlauf
• Share of Voice

schafft die Grundlage für ein automatisiertes System zur SEO-Wettbewerbsbeobachtung.

Anstatt Wettbewerber nur alle paar Monate zu bewerten, kann ihre Sichtbarkeit in den Suchergebnissen zu einer kontinuierlich überwachten Kennzahl werden.

Programmatische SEO-Überwachung

Programmatisches SEO kann Tausende oder Hunderttausende von Landingpages erzeugen.

Eine manuelle Überwachung dieser Projekte ist unrealistisch.

Die Ranktracker-API ermöglicht es Entwicklern, Ranking-Workflows zu erstellen, die große Keyword-Datensätze verarbeiten und die daraus resultierenden Informationen automatisch in interne Analysesysteme übertragen können.

KI-gestützte SEO-Analyse

Die REST-API und der MCP-Server von Ranktracker können ebenfalls in KI-gesteuerte SEO-Workflows integriert werden.

Beispielsweise könnten KI-Systeme dabei helfen:

• Ranking-Einbußen erkennen
• Zusammenfassung von Ranking-Veränderungen
• Schnell an Bedeutung gewinnende Keywords finden
• Sichtbarkeit der Mitbewerber vergleichen
• Änderungen in den SERPs analysieren
• Priorisieren Sie SEO-Chancen
• Interne Berichte erstellen
• Untersuchen Sie ungewöhnliche Ranking-Veränderungen

Die API liefert die strukturierten Daten, während die KI bei deren Interpretation helfen kann.

Für wen ist die Ranktracker-API gedacht?

Die Ranktracker-API ist besonders nützlich für:

• SEO-Agenturen
• Unternehmensinterne SEO-Teams
• SaaS-Unternehmen
• SEO-Softwareunternehmen
• Entwickler
• Dateningenieure
• BI-Teams
• E-Commerce-Unternehmen
• Affiliate-Vermarkter
• Publisher
• Unternehmen mit mehreren Standorten
• Programmatische SEO-Teams
• KI-Automatisierungsteams

Wenn Ranking-Daten automatisch abgerufen, verschoben, analysiert oder verwaltet werden müssen, ist eine API in der Regel eine wesentlich skalierbarere Lösung als manuelle Exporte.

Warum Ranktracker nutzen, anstatt eine eigene Infrastruktur zur Ranking-Verfolgung aufzubauen?

Das Erfassen von Suchrankings in großem Umfang erfordert weit mehr als nur eine Google-Suche.

Ein produktionsreifes Rank-Tracking-System muss Folgendes berücksichtigen:

• Standorte
• Sprachen
• Geräte
• Top-100-Ergebnissammlung
• SERP-Funktionen
• KI-Übersichten
• Keyword-Konfiguration
• Historische Ranking-Daten
• Wettbewerber
• Terminplanung
• Änderungen bei den Suchergebnissen
• Datenspeicherung
• Berichterstellung

Der interne Aufbau und die Wartung dieser gesamten Infrastruktur können erhebliche Entwicklungsressourcen in Anspruch nehmen.

Ranktracker übernimmt die Infrastruktur für das Rank-Tracking und stellt die resultierenden Daten über eine strukturierte API bereit.

Ihre Entwickler können sich daher auf die Entwicklung der Anwendung, des Dashboards, des Workflows oder der Analysen konzentrieren, die Ihr Unternehmen tatsächlich benötigt.

So starten Sie mit der Ranktracker-API

Der Einstieg erfordert nur wenige Schritte.

1. Öffnen Sie Ihre API-Einstellungen

Gehen Sie direkt zu:

https://app.ranktracker.com/account/api

Erstellen Sie einen API-Schlüssel und bewahren Sie ihn sicher auf.

2. Lesen Sie die Schnellstartanleitung

Befolgen Sie die offizielle Schnellstartanleitung:

https://developers.ranktracker.com/guides/quickstart/

3. Senden Sie Ihre erste Anfrage

Beispiel:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

4. Entdecken Sie die API-Referenz

Die vollständige REST-API-Referenz finden Sie hier:

https://developers.ranktracker.com/rest-api/

5. Mit der Entwicklung beginnen

Von dort aus können Sie damit beginnen, Ranktracker mit folgenden Diensten zu verbinden:

• Ihre Anwendung
• Ihr Berichts-Stack
• Ihr Data Warehouse
• Ihr CRM
• Ihre internen Tools
• Ihre KI-Workflows

Ranktracker-API-Dokumentation

Die vollständige Entwicklerdokumentation finden Sie unter:

Entwicklerdokumentation: https://developers.ranktracker.com/

API-Schlüssel erstellen und verwalten: https://app.ranktracker.com/account/api

Schnellstart: https://developers.ranktracker.com/guides/quickstart/

Authentifizierung: https://developers.ranktracker.com/guides/authentication/

Kernkonzepte: https://developers.ranktracker.com/guides/concepts/

Paginierung: https://developers.ranktracker.com/guides/pagination/

Fehler und Ratenbegrenzungen: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Nutzung und Kontingente: https://developers.ranktracker.com/guides/usage-and-quota/

Massenoperationen: https://developers.ranktracker.com/guides/bulk-operations/

Anleitung zum Verfolgen einer Domain: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Anleitung zum Speichern von Rankings im Warehouse: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Anleitung zum „Share of Voice“: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Anleitung zum Massen-Tagging: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

REST-API-Referenz: https://developers.ranktracker.com/rest-api/

MCP-Server: https://developers.ranktracker.com/mcp/

MCP-Client verbinden: https://developers.ranktracker.com/mcp/connect/

MCP-Tool-Referenz: https://developers.ranktracker.com/mcp/tools/

Erste Schritte mit der Ranktracker-API

Die Ranktracker-API verwandelt Ranktracker von einem SEO-Dashboard in eine Infrastruktur, die direkt in Ihren Technologie-Stack integriert werden kann.

Sie können damit Domains und Keywords verwalten, Wettbewerber beobachten, Top-100-Rankings abrufen, SERPs analysieren, KI-Übersichten erkennen, den Share of Voice überwachen, auf historische Ranking-Daten zugreifen, Keywords organisieren, Berichts-Pipelines aufbauen und SEO-Informationen in den Rest Ihres Unternehmens integrieren.

Für Entwickler entfällt dadurch die Notwendigkeit, Ranking-Daten manuell zu exportieren und zu übertragen.

Für Agenturen ermöglicht sie eine groß angelegte Automatisierung von Kundenprozessen.

Für SEO-Teams in Unternehmen ermöglicht es, dass Ranking-Informationen Teil der internen Analyse- und Dateninfrastruktur werden.

Und mit dem MCP-Server von Ranktracker können dieselben zugrunde liegenden SEO-Daten auch KI-Assistenten und -Agenten zugänglich gemacht werden.

Erstellen Sie Ihren Ranktracker-API-Schlüssel: https://app.ranktracker.com/account/api

Lesen Sie die Dokumentation: https://developers.ranktracker.com/

Sehen Sie sich die REST-API-Referenz an: https://developers.ranktracker.com/rest-api/