API-Integrationen & Entwicklerhandbuch

Warum die GEO-Score API verwenden?

Während das GEO-Score Dashboard für manuelle Analysen 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 Berichtstools, um die AI-Suchsichtbarkeit über Ihre gesamte Website automatisch zu überwachen.

Egal 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-Request- und Response-Bodies. Alle Endpoints erfordern Authentifizierung via API-Schlüssel und geben konsistente Response-Strukturen zurück.

Basis-URL

https://api.bloffee.com/v1

Response-Format

Alle API-Responses 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 über Ihre Dashboard-Einstellungen verwaltet werden.

Ihren API-Schlüssel erhalten

Navigieren Sie zu Dashboard > Einstellungen > API-Schlüssel, um einen neuen Schlüssel zu generieren. 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 im Authorization-Header jeder Anfrage ein:

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

Verfügbare Endpoints

Die GEO-Score API bietet Endpoints zum Einreichen von URLs zur Analyse, Abrufen von Ergebnissen, Auslösen von Re-Analysen und Vergleichen mehrerer URLs. Hier ist eine Zusammenfassung aller verfügbaren Endpoints:

GET/urls

Rufen Sie eine paginierte Liste aller analysierten URLs in Ihrem Konto ab.

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

GET/urls/:id

Erhalten Sie die vollständigen Analyseergebnisse für eine bestimmte URL anhand ihrer eindeutigen ID.

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

POST/urls

Reichen Sie eine neue URL zur GEO-Analyse ein. Gibt die Analyse-ID zum Abrufen der Ergebnisse zurück.

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

PUT/urls/:id/refresh

Lösen Sie eine frische Re-Analyse einer zuvor analysierten URL aus.

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

GET/compare

Vergleichen Sie GEO-Scores und Faktor-Aufschlüsselungen über mehrere URLs nebeneinander.

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

Code-Beispiele

Starten Sie schnell mit diesen sofort 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

Webhooks ermöglichen es GEO-Score, Echtzeit-Benachrichtigungen an Ihren Server zu senden, wenn wichtige Ereignisse auftreten. Anstatt die API für Updates abzufragen, konfigurieren Sie eine Webhook-URL und erhalten Sie sofortige Callbacks.

Webhooks einrichten

Konfigurieren Sie Ihren Webhook-Endpoint in Dashboard > Einstellungen > Webhooks. Sie können auswählen, welche Ereignisse Benachrichtigungen auslösen, und ein benutzerdefiniertes Signiergeheimnis zur Payload-Verifizierung festlegen.

analysis.complete Wird ausgelöst, wenn eine URL-Analyse abgeschlossen ist und Ergebnisse verfügbar sind.
score.changed Wird ausgelöst, wenn eine neu analysierte URL eine signifikante GEO-Score-Änderung zeigt (Delta > 5 Punkte).
report.generated Wird ausgelöst, wenn ein geplanter oder On-Demand-Bericht zum Download bereit ist.
url.added Wird ausgelöst, wenn eine neue URL zur Verfolgung zu 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 Blog-Post, 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
•Generieren Sie wöchentliche PDF-Berichte und senden Sie sie 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 nach Content-Updates eine Re-Analyse aus, um die Auswirkung Ihrer Optimierungen zu messen
•Erstellen Sie eine Pre-Publish-Checkliste, die einen Mindest-GEO-Score erfordert, bevor Inhalte live gehen

Drittanbieter-Integrationen

GEO-Score integriert sich mit beliebten Tools und Plattformen, um nahtlos in Ihren bestehenden Workflow zu passen. Verwenden Sie unsere nativen Integrationen oder erstellen Sie Ihre eigenen mit der API.

Zapier

Verbinden Sie GEO-Score mit über 5.000 Apps. Lösen Sie Zaps bei Analyseabschluss, Score-Änderungen oder neuen URLs in Ihrem Konto aus.

WordPress

Installieren Sie das GEO-Score Plugin, um Seiten direkt aus dem WordPress-Editor zu analysieren. Sehen Sie Echtzeit-GEO-Scores während Sie schreiben und veröffentlichen.

Slack

Erhalten Sie sofortige Slack-Benachrichtigungen für 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 benutzerdefinierte Berichte, Trendanalysen und einfaches Teilen mit Ihrem Team.

HubSpot

Bereichern Sie Ihre HubSpot-Content-Strategie mit GEO-Score-Daten. Verfolgen Sie AI-Sichtbarkeit neben Ihren bestehenden Marketing-Metriken.

Google Analytics

Korrelieren Sie GEO-Score-Verbesserungen mit organischen Traffic-Änderungen. Sehen Sie, wie AI-Suchoptimierung Ihren realen Traffic beeinflusst.

Rate-Limits

API-Rate-Limits basieren auf Ihrem Abonnementplan. Anfragen, die Ihr Rate-Limit überschreiten, erhalten eine 429-Response 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 2-fachen Ihres Stundenlimits sind für kurze Zeiträume erlaubt. Kontaktieren Sie den Support, wenn Sie höhere Limits benötigen.

Nächste Schritte

Bereit loszulegen? Generieren Sie Ihren API-Schlüssel auf der Dashboard-Einstellungsseite und probieren Sie die obigen Code-Beispiele aus. Unsere API-Dokumentation enthält detaillierte Request- und Response-Schemas für jeden Endpoint.

Für fortgeschrittene Anwendungsfälle erkunden Sie unser Webhook-System, um ereignisgesteuerte Integrationen zu erstellen. Verwenden Sie den POST /urls Endpoint, um Seiten zur Analyse einzureichen, und den GET /urls/:id Endpoint, um detaillierte Ergebnisse abzurufen.