Entwickler
Öffentliche API
Lesen Sie Ihre Sites, Berichte, Rankings und Keywords über eine einfache, schlüssel-authentifizierte API. Agency-Funktion.
Öffentliche API
Die öffentliche API bietet Lesezugriff auf die Daten, die RankMeFast bereits für Ihr Konto hält — Sites, den letzten Audit-Bericht, den Ranking-Verlauf und die verfolgten Keywords. Sie ist eine Agency-Funktion (siehe Pläne, Limits & Guthaben). Die API löst niemals neue Anbieter-Arbeit aus — sie liest nur, was Ihre Audits und Ranking-Checks bereits erzeugt haben.
Authentifizierung
Erstellen Sie einen Schlüssel unter Konto → API-Schlüssel (/profile?tab=api-keys). Der vollständige Schlüssel wird genau einmal angezeigt — kopieren Sie ihn sofort; danach ist nur noch sein Präfix sichtbar. Sie können bis zu zehn aktive Schlüssel halten und jeden jederzeit widerrufen. Ein widerrufener Schlüssel funktioniert sofort nicht mehr.
Senden Sie den Schlüssel als Bearer-Token mit jeder Anfrage:
Authorization: Bearer rmf_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Ersetzen Sie https://your-rankme-host in den Beispielen unten durch Ihren api-Ursprung (die SERVER_URL Ihrer Installation).
Endpunkte
Ihre Sites auflisten
curl -H "Authorization: Bearer rmf_..." \
https://your-rankme-host/api/v1/sites
Liefert { "sites": [{ "id", "domain", "url", "createdAt" }] }.
Letzter Audit-Bericht einer Site
curl -H "Authorization: Bearer rmf_..." \
https://your-rankme-host/api/v1/sites/<siteId>/report/latest
Liefert den jüngsten erfolgreichen Audit als { "runId", "report" } — dieselben Befunde, Kategorien und lokalisierten Texte wie das Dashboard. Antwortet mit 404, wenn die Site noch keinen abgeschlossenen Audit hat.
Ranking-Verlauf einer Site
curl -H "Authorization: Bearer rmf_..." \
"https://your-rankme-host/api/v1/sites/<siteId>/rank-history?from=2026-06-01&to=2026-07-01"
Liefert { "keywords": [{ "id", "phrase", "series": [...] }] }. Jeder Punkt enthält die Position, die rankende URL und die Google-AI-Overview-Signale (aiOverviewPresent, aiCited, aiCitedUrl). from und to sind optionale ISO-Daten.
Alle verfolgten Keywords
curl -H "Authorization: Bearer rmf_..." \
https://your-rankme-host/api/v1/keywords
Liefert jedes verfolgte Keyword über alle Ihre Sites mit letzter Position, Delta und den AI-Overview-Feldern.
Ratenlimits
Standardmäßig darf jeder Schlüssel 120 Anfragen pro Minute stellen. Darüber antwortet die API mit 429, bis das Fenster zurückgesetzt wird.
Fehler
Fehler haben die Form { "error": { "message": "...", "details": ... } }, lokalisiert nach Ihrem Accept-Language-Header:
401— der Schlüssel fehlt, ist fehlerhaft, widerrufen oder unbekannt.402— Ihr Plan enthält die API nicht.404— die Site oder der Bericht existiert in Ihrem Konto nicht.429— Ratenlimit überschritten (Body:{ "error": "..." }).
Kompatibilität
Dieses Release stellt genau vier schreibgeschützte Routen bereit:
GET /api/v1/sitesGET /api/v1/sites/:siteId/report/latestGET /api/v1/sites/:siteId/rank-historyGET /api/v1/keywords
Markenradar, Bewertungsanalyse, Link-Intelligenz, Traffic-Analyse, Keyword-Trends und SERP-Sensor fügen unter /api/v1 keine Routen hinzu. Die fünf kostenpflichtigen Funktionen bleiben im authentifizierten Dashboard; der öffentliche Sensor bleibt unter /api/volatility. Vorhandene Antwortfelder behalten ihre Bedeutung. Clients sollten zusätzliche unbekannte Felder ignorieren.