Wie nutze ich die UtilitySEO-API?
Auf dieser Seite
Mit der UtilitySEO-API kann Ihre eigene Software Website-Scans und Seiten-Scans für die Website eines Projekts starten und lesen, was der Scan gefunden hat: Gesundheitswert, Probleme, die Seiten mit dem jeweiligen Problem, Lösungshilfen, Ladezeit und mehr. Erstellen Sie einen Schlüssel in den Projekteinstellungen auf dem Tab API-Schlüssel und senden Sie ihn als Bearer-Token. Die API liefert nur Crawler-Daten, nie Daten aus der Search Console, aus Analytics oder Google Ads und nichts über Ihr Konto.
Das Bild zeigt die englische Ansicht. Übersetzte Bilder folgen in Kürze.
Einen Schlüssel erstellen
- Klicken Sie auf dem Bildschirm Projekte auf das Zahnrad des Projekts, um die Projekteinstellungen zu öffnen.
- Öffnen Sie den Tab API-Schlüssel. Nur der Inhaber und Mitglieder mit Vollzugriff können Schlüssel erstellen.
- Geben Sie einen Name des Schlüssels ein, zum Beispiel „Büro-Dashboard“, und klicken Sie auf Schlüssel erstellen.
- Kopieren Sie den Schlüssel sofort. Er wird nur einmal angezeigt, und wir können ihn nicht noch einmal zeigen. Er beginnt mit
usk_live_.
Der Tab listet jeden Schlüssel mit Erstellungsdatum, letzter Nutzung und der Zahl der Aufrufe in den letzten 24 Stunden, 7 Tagen und 30 Tagen. Klicken Sie auf Widerrufen, um einen Schlüssel sofort zu sperren.
Die API nutzen
Senden Sie den Schlüssel bei jeder Anfrage mit, und zwar von Ihrem eigenen Server:
Authorization: Bearer usk_live_...Die Adresse lautet https://utilityseo-production.up.railway.app/api/v1. Die wichtigsten Anfragen:
| Anfrage | Was sie tut |
|---|---|
GET /project | Das Projekt, zu dem der Schlüssel gehört, und seine Seitengrenze |
POST /scans | Einen Website-Scan oder einen Scan einer einzelnen Seite starten |
GET /scans/{id} | Wie weit ein Scan ist |
GET /scans/{id}/results | Gesundheitswert, Probleme, Ladezeit und weitere Ergebnisse |
GET /scans/{id}/export/findings und /export/pages | Alle Ergebnisse und Seiten als Zeilen |
GET /scans | Frühere Scans, auch die in der App gestarteten |
GET /guides | Die Lösungshilfen auf Englisch, Deutsch oder Niederländisch |
PUT /webhook | Benachrichtigung, wenn ein Scan fertig ist. Siehe API-Webhooks |
Ihr Entwickler kann die vollständige Referenz mit allen Feldern und Beispielantworten bei support@utilityseo.com anfordern.
Grenzen
- Scans zählen wie in der App für Ihren Tarif: Website-Scans pro Tag (3 bei Minimum, 5 bei Entrepreneur, unbegrenzt bei fairer Nutzung bei Enterprise) und Seiten pro Scan (500, 2.000 oder 10.000).
- Pro Projekt läuft gleichzeitig ein Website-Scan und ein Seiten-Scan.
- Pro Schlüssel: 60 Anfragen pro Minute und 10 Scan-Starts pro Stunde.
- Die API funktioniert, solange Ihr Konto einen bezahlten Tarif oder eine laufende kostenlose Testphase hat.
Was ein Schlüssel nicht kann
- Andere Projekte, Ihr Konto, Ihre Abrechnung oder Ihre Google-Daten sehen.
- Im Browser auf einer Seite Ihrer Website genutzt werden. Bewahren Sie ihn auf Ihrem Server auf.
- Scans planen. UtilitySEO startet Scans nicht nach Zeitplan; rufen Sie
POST /scansaus Ihrem eigenen Zeitplaner auf, zum Beispiel einmal pro Woche.
Häufige Fragen
Was ist der Unterschied zwischen einem API-Schlüssel und einem Connector-Schlüssel?
Ein API-Schlüssel ist für Ihre eigene Software und gehört zu einem Projekt. Ein Connector-Schlüssel aus Einstellungen, Konto, Eigene KI verbinden lässt Ihr eigenes Claude oder ChatGPT Ihr ganzes Konto lesen. Siehe UtilitySEO in Claude oder ChatGPT nutzen.
Mein Schlüssel funktioniert nicht mehr. Warum?
Er wurde widerrufen, das Konto wurde geschlossen, die kostenlose Testphase endete ohne Tarif, oder die Person, die ihn erstellt hat, hat keine Inhaber- oder Vollzugriffsrechte mehr für das Projekt. Siehe API-Fehler.
Gibt es eine Adresse api.utilityseo.com?
Noch nicht. Verwenden Sie die Adresse oben.