Warum die GEO-Score API verwenden?
Während das GEO-Score Dashboard für die manuelle Analyse leistungsstark ist, ermöglicht die API Automatisierung im großen Maßstab. Integrieren Sie GEO-Analysen direkt in Ihr Content-Management-System, Ihre CI/CD-Pipeline oder benutzerdefinierte Reporting-Tools, um die KI-Suchsichtbarkeit auf Ihrer gesamten Website automatisch zu überwachen.
Ob Sie ein Solo-Entwickler sind, der seinen eigenen Workflow automatisiert, oder eine Agentur, die Hunderte von Kunden-Websites verwaltet – die API gibt Ihnen programmatischen Zugriff auf jede im Dashboard verfügbare Funktion und mehr.
API-Übersicht
Die GEO-Score API folgt RESTful-Konventionen mit JSON-Anfragen und -Antworten. Alle Endpunkte erfordern eine Authentifizierung über einen API-Schlüssel und liefern konsistente Antwortstrukturen.
Basis-URL
Antwortformat
Alle API-Antworten folgen einer konsistenten JSON-Struktur mit Statuscodes und verschachtelten Datenobjekten:
Authentifizierung
Jede API-Anfrage muss Ihren API-Schlüssel im Authorization-Header enthalten. API-Schlüssel sind auf Ihr Konto beschränkt und können in den Dashboard-Einstellungen verwaltet werden.
API-Schlüssel erhalten
Navigieren Sie zu Dashboard > Einstellungen > API-Schlüssel, um einen neuen Schlüssel zu erstellen. Sie können mehrere Schlüssel mit unterschiedlichen Berechtigungen für verschiedene Integrationen erstellen. Jeder Schlüssel kann einzeln widerrufen werden, ohne andere zu beeinträchtigen.
Ihren API-Schlüssel verwenden
Fügen Sie Ihren API-Schlüssel als Bearer-Token in den Authorization-Header jeder Anfrage ein:
Verfügbare Endpunkte
Die GEO-Score API bietet Endpunkte zum Einreichen von URLs für die Analyse, zum Abrufen von Ergebnissen, zum Auslösen von Re-Analysen und zum Vergleichen mehrerer URLs. Hier ist eine Zusammenfassung aller verfügbaren Endpunkte:
Eine paginierte Liste aller analysierten URLs in Ihrem Konto abrufen.
Die vollständigen Analyseergebnisse für eine bestimmte URL anhand ihrer eindeutigen ID abrufen.
Eine neue URL zur GEO-Analyse einreichen. Gibt die Analyse-ID zum Abfragen der Ergebnisse zurück.
Eine neue Re-Analyse einer zuvor analysierten URL auslösen.
GEO-Scores und Faktoraufschlüsselungen mehrerer URLs nebeneinander vergleichen.
Code-Beispiele
Beginnen Sie schnell mit diesen einsatzbereiten Code-Beispielen in beliebten Programmiersprachen. Kopieren, einfügen und für Ihren spezifischen Anwendungsfall anpassen.
JavaScript (Node.js)
Python
PHP
Webhooks
Mit Webhooks kann GEO-Score Echtzeit-Benachrichtigungen an Ihren Server senden, wenn wichtige Ereignisse auftreten. Anstatt die API auf Updates abzufragen, konfigurieren Sie eine Webhook-URL und erhalten sofortige Callbacks.
Einrichtung von Webhooks
Konfigurieren Sie Ihren Webhook-Endpunkt in Dashboard > Einstellungen > Webhooks. Sie können auswählen, welche Ereignisse Benachrichtigungen auslösen, und ein benutzerdefiniertes Signing-Secret für die Payload-Verifizierung festlegen.
analysis.complete
Wird ausgelöst, wenn eine URL-Analyse die Verarbeitung abgeschlossen hat und Ergebnisse verfügbar sind.
score.changed
Wird ausgelöst, wenn eine erneut analysierte URL eine signifikante GEO-Score-Änderung zeigt (Delta > 5 Punkte).
report.generated
Wird ausgelöst, wenn ein geplanter oder bedarfsgesteuerter Bericht zum Download bereit ist.
url.added
Wird ausgelöst, wenn eine neue URL zur Verfolgung in Ihrem Konto hinzugefügt wird.
Beispiel-Webhook-Payload
Automatisierungsideen
Analysieren Sie automatisch jeden neuen Blogbeitrag, der in Ihrem CMS veröffentlicht wird, bevor er live geht
Richten Sie Slack-Benachrichtigungen ein, wenn eine verfolgte URL unter einen GEO-Score-Schwellenwert fällt
Erstellen Sie wöchentliche PDF-Berichte und senden Sie diese per E-Mail an Ihre Kunden oder Stakeholder
Erstellen Sie ein benutzerdefiniertes Dashboard, das GEO-Score-Daten mit Ihrer Analytics-Plattform kombiniert
Lösen Sie eine erneute Analyse nach Inhaltsaktualisierungen aus, um die Auswirkungen Ihrer Optimierungen zu messen
Erstellen Sie eine Pre-Publish-Checkliste, die einen Mindest-GEO-Score erfordert, bevor Inhalte live gehen
Drittanbieter-Integrationen
GEO-Score lässt sich in beliebte Tools und Plattformen integrieren, um sich nahtlos in Ihren bestehenden Workflow einzufügen. Nutzen Sie unsere nativen Integrationen oder erstellen Sie mit der API Ihre eigenen.
Zapier
Verbinden Sie GEO-Score mit über 5.000 Apps. Lösen Sie Zaps bei Analyseabschluss, Score-Änderungen oder neuen URLs aus, die Ihrem Konto hinzugefügt werden.
WordPress
Installieren Sie das GEO-Score-Plugin, um Seiten direkt aus dem WordPress-Editor zu analysieren. Sehen Sie GEO-Scores in Echtzeit, während Sie schreiben und veröffentlichen.
Slack
Erhalten Sie sofortige Slack-Benachrichtigungen über Score-Änderungen, abgeschlossene Analysen und wöchentliche Zusammenfassungsberichte in Ihrem gewählten Kanal.
Google Sheets
Synchronisieren Sie GEO-Score-Daten automatisch mit Google Sheets für individuelle Berichte, Trendanalysen und einfaches Teilen mit Ihrem Team.
HubSpot
Bereichern Sie Ihre HubSpot-Content-Strategie mit GEO-Score-Daten. Verfolgen Sie die KI-Sichtbarkeit zusammen mit Ihren bestehenden Marketing-Kennzahlen.
Google Analytics
Korrelieren Sie GEO-Score-Verbesserungen mit Veränderungen im organischen Traffic. Sehen Sie, wie sich KI-Suchoptimierung auf Ihren tatsächlichen Traffic auswirkt.
Rate-Limits
API-Rate-Limits gelten pro Konto und werden von jedem Plan geteilt, vom kostenlosen Tarif bis zum Unbegrenzten Abo für €29,99/Monat. Anfragen, die Ihr Rate-Limit überschreiten, erhalten eine 429-Antwort mit einem Retry-After-Header, der angibt, wann Sie fortfahren können.
Rate-Limits werden in einem rollierenden Ein-Stunden-Fenster zurückgesetzt. Kontaktieren Sie den Support, wenn Sie höhere Limits benötigen.
Nächste Schritte
Bereit loszulegen? Erstellen Sie Ihren API-Schlüssel auf der Dashboard-Einstellungsseite und probieren Sie die obigen Code-Beispiele aus. Unsere API-Dokumentation enthält detaillierte Anfrage- und Antwortschemata für jeden Endpunkt.
Für fortgeschrittene Anwendungsfälle können Sie unser Webhook-System erkunden, um ereignisgesteuerte Integrationen zu erstellen. Verwenden Sie den POST /urls-Endpunkt, um Seiten zur Analyse einzureichen, und den GET /urls/:id-Endpunkt, um detaillierte Ergebnisse abzurufen.