SEO-API

Erstellen Sie eigene SEO-Berichte und Automatisierungen mit strukturiertem JSON aus Ihren Screpy-Projekten. Rufen Sie Crawl-Befunde, Keyword-Rankings, Backlinks, gespeicherte AI Visibility und Monitoring-Ergebnisse über eine projektbezogene REST API ab und verwalten Sie Ihren Ablauf mit unterstützten Aktionen.

API-Schnellstart lesen Screpy-Konto erstellen

Zugängliche Projekte auflisten

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Beispielhafter Antwortauszug. REST-Zugriff erfordert ein zahlendes Mitgliedskonto; der Schlüssel liefert nur eigene oder geteilte Projekte, auf die Sie zugreifen können.

SEO API authentifizieren

Erstellen Sie unter Einstellungen → Verbundene Apps einen REST-Schlüssel und senden Sie ihn von Ihrem Server als Bearer-Token. Wählen Sie die benötigten Berechtigungen.

Leseschlüssel rufen Daten ab; Lese- und Schreibschlüssel ermöglichen zusätzlich unterstützte Änderungen.
Kopieren Sie das Geheimnis beim Erstellen: Es wird nur einmal angezeigt. Verwenden Sie es nicht in öffentlichem Browsercode.
Widerrufen Sie Schlüssel unter Verbundene Apps. Maximal 20 aktive Schlüssel sind erlaubt; sie laufen nach einem Jahr ab.

Authentifizierungsleitfaden lesen

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

API-Zugriff prüfen

REST-Zugriff erfordert ein zahlendes Mitgliedskonto. Projektmitgliedschaft und die Funktionsberechtigung des Projekts bestimmen ebenfalls, welche Daten und Aktionen verfügbar sind.

Konto-Endpunkte zeigen Tarif, Funktionen und die Anzahl zugänglicher Projekte.
Nutzungsberichte enthalten Funktionslimits; verbrauchte und verbleibende Mengen werden derzeit nur für eigene Projekte berechnet.
Null bei der Nutzung bedeutet einen nicht verfügbaren Wert, nicht null Verbrauch.

Konto-Endpunkte ansehen

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

SEO-Projekte verwalten

Listen Sie eigene und geteilte Projekte auf, rufen Sie eine Projektübersicht ab oder erstellen Sie Projekte innerhalb Ihres Limits für eigene Projekte. Verwenden Sie die zurückgegebenen Projekt-UIDs für weitere Anfragen.

Aktualisieren Sie Namen, Markt- und Zeitzoneneinstellungen sowie unterstützte Crawl- oder Monitoring-Einstellungen.
Eine andere Domain erfordert ein neues Projekt; Einstellungsänderungen schreiben abgeschlossene Ergebnisse nicht um.
Die Projekterstellung prüft Kapazität und Website-Validierung.
Nur der Projekteigentümer darf ein Projekt löschen.

Projekt-Endpunkte ansehen

example.comProjekt

example.orgProjekt

example.netProjekt

Website-Crawls starten

Starten Sie einen Crawl mit Schreibzugriff und speichern Sie seine Crawl-UID. Der Crawl läuft im Hintergrund; verfolgen Sie den Status, bevor Sie Ergebnisse abrufen.

Ein laufender Crawl oder ein deaktivierter Crawler kann einen neuen Start verhindern.
Zusammenfassungen und Datensätze erfordern einen erfolgreich abgeschlossenen Crawl; unfertige Ergebnisse liefern einen Konflikt.
Halten Sie Projekt- und Crawl-Referenzen beim Berichten oder Vergleichen von Momentaufnahmen zusammen.

Crawl-Endpunkte ansehen

1
Prüfung/guides
Offen
2
Erstellt/shop
Offen
Abgeschlossenexample.com
Ausstehend

SEO-Crawl-Daten abrufen

Erstellen Sie technische SEO-Berichte aus einem ausgewählten abgeschlossenen Crawl. Rufen Sie Seitendetails ab und verfolgen Sie Links oder Bilder zu ihren Quellseiten.

Seiten enthalten HTTP-Status, Titel, Beschreibungen, Überschriften, Canonicals, Crawl-Tiefe und Zeitangaben.
Link-Datensätze zeigen Ziele, Ankertexte, Nofollow-Status und den Quellseitenkontext.
Bild-Datensätze enthalten Alternativtext, Abmessungen, Abrufstatus und Quellseiten.
Verwenden Sie unterstützte Feldfilter und paginierte Datensätze; dies ist kein vollständiger HTML-Export oder SQL-Zugang.

Crawl-Daten-Endpunkte ansehen

/guides/seo200

Indexiert

Projekte und Crawls vergleichen

Vergleichen Sie technische SEO-Zusammenfassungen zwischen Projekten oder abgeschlossenen Crawl-Momentaufnahmen. Speichern Sie eindeutige Crawl-Referenzen für reproduzierbare Vergleiche.

Projektvergleiche akzeptieren zwei bis fünf zugängliche Projekte mit neuesten abgeschlossenen Crawls oder ausgewählten Momentaufnahmen.
Zwei-Crawl-Vergleiche liefern Änderungen bei Gesundheit, Seiten und Problemen als zweiter minus erster Wert.
Dies sind Zusammenfassungsvergleiche; rufen Sie Crawl-Datensätze separat ab, um einzelne URLs zu untersuchen.

Vergleichs-Endpunkte ansehen

Vorher62→Nachher87

SEO Quick Wins abrufen

Übernehmen Sie priorisierte Chancen mit Quelle und Berichtszeitraum in Ihren Ablauf. Eine abgeschlossene Crawl-Referenz prüft den Zugriff, macht aber nicht jede Chance zur Momentaufnahme dieses Crawls.

Bei verfügbaren verbundenen Daten umfassen Search-Console-Chancen aussichtsreiche Suchanfragen, CTR, Kannibalisierung, Rückgänge und Sichtbarkeitsänderungen.
Interne Link-Befunde können sich auf den neuesten Projekt-Crawl beziehen, der in den Antwortmetadaten steht.
Traffic-basierte Befunde erfordern die passende Verbindung, Berechtigungen und ausreichend Daten.
Bewahren Sie Berichtstypen, Zeitraum, Warnungen und Verfügbarkeit; ein leerer Bericht beweist keine fehlerfreie Website.

Quick Wins entdecken

linen shirt#11

Impressionen

2.860

Rank Tracking verwalten

Lesen Sie gespeicherte Keyword-Sichtbarkeit, Analyseverläufe und Ranking-Ergebnisse im Markt- und Gerätekontext. Verwalten Sie die getrackten Keywords, statt beliebige Live-Suchergebnisse anzufordern.

Filtern Sie Keywords nach Suche, Gerät und URL-basiertem Segment, einschließlich nicht zugeordneter Keywords.
Fügen Sie bis zu 100 Keywords je Anfrage hinzu; die erste Analyse wird eingereiht und nicht sofort zurückgegeben.
Löschen Sie getrackte Keywords und prüfen, erstellen, ändern oder entfernen Sie Segmente mit Schreibzugriff.
REST bietet keine Live-SERP-Abfrage, manuelle Neuanalyse oder CSV/XLSX-Exporte für Rank Tracker.

Rank-Tracker-Endpunkte ansehen

Rankings

+24 Position

Auf AI Visibility zugreifen

Verknüpfen Sie gespeicherte KI-Antworten mit Markenerwähnungen, Zitierungen und Quellenbelegen. Bewahren Sie Prompt-, Länder-, Sprach- und Plattformkontext in eigenen Berichten.

Lesen Sie Übersichten, Erwähnungen, Antworten, Zitierungen, getrackte Prompts und Aktivitäten von Quelldomains oder URLs.
Fügen Sie innerhalb der Projektkapazität bis zu 20 Prompts je Anfrage hinzu oder entfernen Sie getrackte Prompts mit Schreibzugriff.
Prompt-Vorschläge, manuelle Neuanalysen und AI-Visibility-Exporte sind keine REST-Operationen.

AI Visibility entdecken

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Backlinks analysieren

Lesen Sie das Backlink-Profil eines Projekts oder eines bereits hinzugefügten Wettbewerbers aus den verfügbaren Optionen. Verknüpfen Sie einzelne Links mit verweisenden Domains für eigene Autoritätsberichte.

Rufen Sie Übersichtsmetriken, verweisende Domains und Backlinks einer ausgewählten Domain ab.
Prüfen Sie Backlink-Lücken und unterstützte Datensätze zu verlorenen oder fehlerhaften Domains.
Bewahren Sie Ziel, Filter, Sortierung und Cursor-Kontext; beliebige Domains lassen sich nicht uneingeschränkt abfragen.
CSV/XLSX-Tabellenexporte umfassen die aktuelle Seite. Setzen Sie den Abruf mit X-Next-Cursor fort.

Backlink Checker entdecken

example.org
example.net
example.edu

example.com84 Links

Disavow-Einträge verwalten

Speichern Sie geprüfte Domain- oder URL-Einträge mit Notizen im Projekt und erstellen Sie eine Textdatei im Google-Format. Disavow-Entscheidungen treffen Sie selbst.

Mit Schreibzugriff können Sie bis zu 100 Einträge je Anfrage hinzufügen oder vorhandene Einträge löschen.
Exportieren Sie den Disavow-Text des Projekts getrennt von paginierten Tabellenexporten.
Prüfen und übermitteln Sie die Datei manuell; ein gespeicherter Eintrag wird nicht an Google gesendet und entfernt keinen Backlink.

Disavow Management entdecken

disavow.txtPrüfung

domain:example.org
https://example.net/links

Domainexample.org
URLexample.net/links

Website-Gesundheit abrufen

Trennen Sie Seitenleistung und Website-Verfügbarkeit in Ihren Berichten. Diese Endpunkte liefern vorhandene Prüfungen, keine neue Messung auf Abruf.

Performance liefert die zuletzt geprüfte Startseite mit FCP, LCP, CLS, TTFB, TBT und Speed Index – nicht jede Seite oder einen vollständigen Verlauf.
Uptime fasst die letzten 30 Tage zusammen und liefert maximal die neuesten 160 Prüfungen mit Status, Antwortzeit und Datum.
Fehlende Performance ist data:null; ohne Uptime-Prüfungen bleiben Zusammenfassungswerte null und die Prüfliste leer.

Gesundheits-Endpunkte ansehen

example.comLabor

LCP2,1 s
TBT180 ms
CLS0,04

SEO-Daten paginieren

Rufen Sie größere Datensätze in überschaubaren Seiten ab und bewahren Sie den Anfragekontext in Ihrer Pipeline. Prüfen Sie die Verfügbarkeit, bevor Sie Antworten als Dashboard-Metriken verwenden.

Unterstützte Listen liefern standardmäßig 50 und höchstens 100 Datensätze; folgen Sie den nächsten Links oder undurchsichtigen Cursorn.
Halten Sie Filter, Ziele und Berichtszeiträume über Seiten hinweg konstant. Ungültige Parameter werden abgewiesen.
Behandeln Sie Berechtigungs-, unfertige Crawl-, Verfügbarkeits- und Ratenlimitfehler ausdrücklich, statt fehlende Ergebnisse durch den Zahlenwert 0 zu ersetzen.

API-Fehlerleitfaden lesen

JSONcursor_2

Über SEO-API sprechen. Mit SEO MCP.

Verbinden Sie Ihren KI-Assistenten über SEO MCP mit Ihrem Screpy-Projekt. Wählen Sie ein Projekt, prüfen Sie die Übersicht und untersuchen Sie unterstützte Crawl-, Ranking- und Suchdaten mit begrenztem Zugriffsbereich.

Screpy SEO MCP entdecken KI-Assistenten verbinden

SEO API FAQ

Praktische Antworten zu REST-Zugriff, Datensätzen und einer verlässlichen Integration.

Welche API-Ratenlimits gelten?

Pro Minute gilt ein Basislimit von 300 Anfragen je Schlüssel und 900 je Konto. Aufwendige Endpunkte erlauben zusätzlich 60 je Schlüssel und 180 je Konto; Schreib-Endpunkte 30 und 90. Die Prüfungen gelten gemeinsam. Behandeln Sie HTTP 429 und wiederholen Sie nach der zulässigen Wartezeit.

Sind alle API-Ergebnisse aktuell oder live?

Nein. Crawl-Daten gehören zur ausgewählten Momentaufnahme; Rankings und AI Visibility nutzen gespeicherte Analysen. Quick Wins folgt Quelle und Berichtszeitraum. Gesundheits-Endpunkte liefern vorhandene Prüfungen. Bewahren Sie verfügbare Zeitstempel und Quellenkontext in Berichten.

Wie unterscheidet sich SEO API von SEO MCP?

SEO API ist für selbst entwickelte Software gedacht, mit REST-Anfragen und einem REST-Bearer-Schlüssel. SEO MCP stellt unterstützte Werkzeuge kompatiblen KI-Assistenten über das Model Context Protocol und eigene Autorisierung bereit. MCP-Zugangsdaten authentifizieren REST nicht; die verfügbaren Operationen sind nicht identisch.

Funktioniert ein Leseschlüssel bei jeder POST-Anfrage?

Nein. POST-Projekt- und Crawl-Vergleiche akzeptieren Lesezugriff, weil sie vorhandene Datensätze analysieren. Datensätze erstellen oder ändern, Crawls starten und Segmente vorab prüfen erfordert Lese- und Schreibzugriff. Prüfen Sie den dokumentierten Berechtigungsumfang statt nur die HTTP-Methode.

Wie finde ich Projekt-UID und Crawl-UID?

Rufen Sie GET /projects auf, wählen Sie ein zugängliches Projekt und laden Sie dessen Crawl-Liste. Verwenden Sie die zurückgegebenen Projekt- und Crawl-UIDs zusammen. Zusammenfassungs- und Crawl-Daten-Endpunkte erfordern einen erfolgreich abgeschlossenen Crawl.

Stellt REST jede Dashboard-Funktion bereit?

Nein. Unterstützte REST-Operationen stehen in der API-Referenz. Es gibt keine REST-Endpunkte für Map-Tracker-Ergebnisse, Artikelerstellung, PDF-Berichte oder vollständige Roh-Analytics. Für Rank Tracker und AI Visibility gelten ebenfalls die oben beschriebenen Aktions- und Exportgrenzen.

Kann ich API-Daten als CSV oder Excel exportieren?

Backlink-Tabellen-Endpunkte unterstützen CSV/XLSX für die aktuelle Seite mit X-Next-Cursor zur Fortsetzung. Disavow-Text hat einen separaten Export. CSV/XLSX-Exporte für Rank Tracker und AI Visibility bleiben dem Dashboard vorbehalten; andere strukturierte API-Antworten können Ihren eigenen Berichtscode versorgen.

Bedeuten fehlende Daten, dass keine SEO-Probleme vorliegen?

Nein. Null-Werte, leere Datensätze, Warnungen und Verfügbarkeitsfehler bedeuten Unterschiedliches. Eine fehlende Performance-Prüfung ist kein Website-Ausfall, ein nicht verfügbarer Nutzungswert kein Verbrauch von null. Prüfen Sie Antwort und Einrichtung vor Schlussfolgerungen.