Surfer bietet eine API, mit der Sie auf Kernfunktionen zugreifen können, einschließlich Audits, Content-Erstellung und mehr. Die API ist für Entwickler, technische SEO-Spezialisten und Partner geeignet, die Surfers Funktionen in ihre Workflows oder Tools integrieren möchten.
Die folgenden Surfer-Funktionen sind derzeit nur im Dashboard verfügbar und haben keine API-Endpunkte:
Funktion | Warum es wichtig ist |
Internal Linking Engine | Surfers GSC-integriertes Link-Vorschlagstool funktioniert ausschließlich im Dashboard |
Topical Maps / Sites View | Keyword-Clustering und Content-Silo-Planung sind nur in der Benutzeroberfläche verfügbar |
Anpassung von Konkurrenten | Im Dashboard können Sie Konkurrenten (z. B. Wikipedia, Pinterest) aus der SERP-Analyse abwählen; die API verwendet Surfers Standard-Top-10-Auswahl |
Plagiatsprüfer | Die Plagiatsprüfung vor der Veröffentlichung wird nur im Browser-Editor ausgeführt |
AI Tracker | AI-Sichtbarkeitsverfolgung und -überwachung werden (noch) nicht über die API bereitgestellt, aber wir arbeiten derzeit daran |
Wenn Sie einen programmatischen Workflow erstellen, sollten Sie das Dashboard für Aufgaben in der Strategiephase (thematische Zuordnung, Konkurrenzbereinigung, interne Verlinkung) und die API für die Ausführung (Erstellen von Editoren, Generieren von Inhalten, Durchführen von Audits) verwenden.
Diese Funktion ist mit dem Plan „Peace of Mind" oder „Enterprise" verfügbar. Um zu überprüfen, ob dies die richtige Lösung ist, oder um andere verfügbare Optionen zu erkunden, wenden Sie sich bitte über dieses Formular oder per E-Mail an unser Vertriebsteam unter [email protected].
Alle Anfragen ohne ordnungsgemäßen Zugriff werden blockiert, auch wenn ein gültiger API-Schlüssel bereitgestellt wird.
Sie können Aktionen mit API-Anfragen automatisieren, ohne jedes Mal die Surfer-Web-App zu öffnen. Dies umfasst:
Erstellen und Verwalten von Content Editor-Abfragen
Inhaltserstellung über Surfer AI
Ausführen von Audit-Berichten
Zugriff auf SERP Analyzer-Daten
Generieren von teilbaren Links
Abrufen strukturierter Daten für benutzerdefinierte Dashboards
Erkennen Sie KI-generierte Inhalte in Ihrem Text (AI Detector)
Text humanisieren (umformulieren, um natürlicher zu klingen und dabei die Bedeutung beizubehalten)
... und mehr – beschrieben in unserer API-Dokumentation!
Details zu Endpunkten, Authentifizierung und Request-/Response-Formaten finden Sie hier 👉 Surfer API V1 Dokumentation.
Für vollständige Details zu Endpunkten, Authentifizierung und Request-/Response-Formaten navigieren Sie hier 👉 Surfer API V2 Dokumentation.
Neuerungen in V2:
- Content Editor-Verwaltung: Erstellen und verwalten Sie Content Editor-Dokumente über die API.
- Neue Content Score: Greifen Sie auf Scores basierend auf dem aktualisierten Scoring-Modell zu (umfasst sowohl SEO als auch AI Visibility).
- Outline-Generierung: Generieren Sie Content-Outlines programmgesteuert.
- Surfer AI: Lösen Sie Surfer AI-Schreiben über die API aus.
Die Surfer API verwendet API-Schlüssel zur Authentifizierung. Wenn Sie bereits das Peace of Mind oder Enterprise Plan abonniert haben und Ihren API-Schlüssel benötigen, kontaktieren Sie uns über Live Chat oder per E-Mail unter [email protected].
Sie müssen Ihre Aufrufe als Kontoinhaber authentifizieren. Kein anderes Mitglied, auch nicht Administratoren, kann dies tun. Weitere Informationen zu Rollen finden Sie hier.
Fügen Sie Ihren API-Schlüssel im Request-Header mit dem API-KEY Feld ein. Anfragen ohne einen gültigen Schlüssel oder ohne den erforderlichen Plan oder Add-on erhalten eine 401 "Access Denied" Antwort.
Wenn Sie Ihren API-Schlüssel verloren haben, können Sie über unseren Support unter [email protected] einen neuen anfordern. Wir senden Ihnen Ihren Schlüssel erneut zu oder generieren auf Wunsch einen neuen.
Wir bieten derzeit keine Sandbox-Umgebung an. Alle API-Anfragen, die Sie senden, verbrauchen tatsächliche Limits aus Ihrem Konto und werden auf das Kontingent Ihres Plans angerechnet.
Der API-Zugriff entsperrt nicht automatisch alle API-kompatiblen Tools. Wenn Ihr Plan oder Add-on keine Tools wie Audit oder SERP Analyzer enthält, funktionieren die entsprechenden Endpunkte nicht, auch nicht mit einem gültigen API-Schlüssel.
Sie erhalten möglicherweise Fehlermeldungen wie 403 "Forbidden", 422 "Quota exceeded" oder 500 "Internal server error", je nach Tool und Aufruf.
