API-Integrationen & Entwicklerleitfaden

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

https://api.bloffee.com/v1

Antwortformat

Alle API-Antworten folgen einer konsistenten JSON-Struktur mit Statuscodes und verschachtelten Datenobjekten:

{
  "status": "success",
  "data": {
    "url": "https://example.com/page",
    "geoScore": 85,
    "factors": {...}
  }
}

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.

Authorization: Bearer YOUR_API_KEY_HERE

Ihren API-Schlüssel verwenden

Fügen Sie Ihren API-Schlüssel als Bearer-Token in den Authorization-Header jeder Anfrage ein:

curl -X GET \
  https://api.bloffee.com/v1/urls \
  -H "Authorization: Bearer YOUR_API_KEY"

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:

GET/urls

Eine paginierte Liste aller analysierten URLs in Ihrem Konto abrufen.

GET https://api.bloffee.com/v1/urls?page=1&limit=50

GET/urls/:id

Die vollständigen Analyseergebnisse für eine bestimmte URL anhand ihrer eindeutigen ID abrufen.

GET https://api.bloffee.com/v1/urls/abc123

POST/urls

Eine neue URL zur GEO-Analyse einreichen. Gibt die Analyse-ID zum Abfragen der Ergebnisse zurück.

POST https://api.bloffee.com/v1/urls

PUT/urls/:id/refresh

Eine neue Re-Analyse einer zuvor analysierten URL auslösen.

PUT https://api.bloffee.com/v1/urls/abc123/refresh

GET/compare

GEO-Scores und Faktoraufschlüsselungen mehrerer URLs nebeneinander vergleichen.

GET https://api.bloffee.com/v1/compare?urls=id1,id2,id3

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)

const fetch = require('node-fetch');

const analyzeURL = async (url) => {
  const response = await fetch('https://api.bloffee.com/v1/urls', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ url })
  });

  const data = await response.json();
  console.log('GEO Score:', data.data.geoScore);
  return data;
};

analyzeURL('https://example.com/my-page');

Python

import requests

def analyze_url(url):
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }

    response = requests.post(
        'https://api.bloffee.com/v1/urls',
        headers=headers,
        json={'url': url}
    )

    data = response.json()
    print(f"GEO Score: {data['data']['geoScore']}")
    return data

analyze_url('https://example.com/my-page')

PHP

<?php
$url = 'https://example.com/my-page';

$data = array('url' => $url);
$options = array(
    'http' => array(
        'header'  => "Authorization: Bearer YOUR_API_KEY
" .
                     "Content-Type: application/json
",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents(
    'https://api.bloffee.com/v1/urls',
    false,
    $context
);

$response = json_decode($result, true);
echo "GEO Score: " . $response['data']['geoScore'];
?>

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

{
  "event": "analysis.complete",
  "timestamp": "2025-01-10T12:00:00Z",
  "data": {
    "url_id": "abc123",
    "url": "https://example.com/page",
    "geoScore": 85,
    "previousScore": 78,
    "factors": {
      "readability": 90,
      "comprehensiveness": 82,
      "aiOptimization": 85
    }
  }
}

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 basieren auf Ihrem Abonnementplan. Anfragen, die Ihr Rate-Limit überschreiten, erhalten eine 429-Antwort mit einem Retry-After-Header, der angibt, wann Sie fortfahren können.

Starter

100

Anfragen pro Stunde

Pro

1,000

Anfragen pro Stunde

Enterprise

Individuell

Kontaktieren Sie uns für Limits

Rate-Limits werden in einem rollierenden Ein-Stunden-Fenster zurückgesetzt. Burst-Anfragen bis zum Doppelten Ihres Stundenlimits sind für kurze Zeiträume zulässig. 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.