SEO-API

Die Screpy SEO-API ist eine REST-API, mit der Sie Projekt-, Crawl-, Rank-Tracker-, gespeicherte AI-Visibility-, Seiten-, Monitoring- und Opportunity-Daten in eigene Produkte, Dashboards und Automatisierungen integrieren. Verwenden Sie strukturierte JSON-Antworten für SEO-Workflows mit den Daten, auf die Ihr Screpy-Konto zugreifen darf.

API-Schnellstart lesen Kostenlose Testversion starten

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

Fragen zur SEO-API.

Erfahren Sie, wie die Screpy-REST-API Anfragen authentifiziert, Projekte und Crawls abgrenzt und Daten für eigene SEO-Produkte und Automatisierungen bereitstellt.

Wer kann die Screpy SEO-API verwenden?

Die Screpy-REST-API steht kostenpflichtigen Mitgliederkonten zur Verfügung. Jede Anfrage prüft aktuelle Berechtigung, Funktionskontingente und Zugriff auf das angeforderte Projekt.

Wie finde ich eine Projekt-UID und Crawl-UID?

Beginnen Sie mit GET /projects, um die für den API-Schlüssel verfügbaren Projekte zu listen. Verwenden Sie die ausgewählte Projekt-UID mit der Crawl-Liste, die die Crawl-UID für projektspezifische Crawl-Datenanfragen liefert.

Kann ich AI Visibility über die API verwenden?

Ja. Die API liest gespeicherte Übersichts-, Erwähnungs-, Antwort-, Zitations-, Prompt- und Quelldaten der AI Visibility und kann verfolgte Prompts hinzufügen oder soft löschen. CSV- und Excel-Exporte bleiben auf das Dashboard beschränkt; Prompt-Vorschläge und manuelle Neuanalyse sind über die API nicht verfügbar.

Welche Crawl-Daten kann die Screpy SEO-API zurückgeben?

Für einen ausgewählten abgeschlossenen Crawl kann die REST-API Seiten, Links, Bilder, On-Page-Ergebnisse und Quick Wins zurückgeben. Halten Sie Projekt- und Crawl-Bereich beim Erstellen von Berichten oder Automatisierungen zusammen.

Kann ich Core Web Vitals und Verfügbarkeit über die API abrufen?

Ja. Core Web Vitals und Verfügbarkeit werden über getrennte Health-Endpunkte bereitgestellt, da Performance und Verfügbarkeit unterschiedliche Signale sind. Eine data: null-Antwort kann bedeuten, dass noch keine passende Prüfung verfügbar ist.

Kann die Screpy SEO-API Crawls vergleichen?

Ja. Die Vergleichs-API akzeptiert zwei Referenzen auf abgeschlossene Crawls und liefert einen strukturierten Vergleich zur Untersuchung von Änderungen zwischen Crawl-Basisständen.

Kann ich Rank Tracker über die API verwalten?

Ja. Die API unterstützt Rank-Tracker-Übersicht, Keyword-Auflistung und -Verwaltung, gespeicherte Analyseverläufe und Ergebnisse sowie Segmentvorschau oder -verwaltung. CSV/XLSX-Export, Live-SERP-Abfrage und manuelle Neuanalyse werden nicht unterstützt.

Wie erstelle ich einen Screpy-SEO-API-Schlüssel?

Erstellen Sie unter Einstellungen → Verbundene Apps einen REST-API-Schlüssel und senden Sie ihn bei jeder Anfrage als Bearer-Token. MCP-OAuth-Zugangsdaten authentifizieren die Screpy-REST-API nicht.

Worin unterscheidet sich die Screpy SEO-API von SEO MCP?

Die Screpy SEO-API ist eine REST-API für eigene Produkte, Dashboards und Automatisierungen und wird mit einem REST-API-Schlüssel authentifiziert. Screpy SEO MCP stellt kompatiblen KI-Assistenten strukturierte Screpy-Tools über OAuth und das Model Context Protocol bereit.