Sie möchten Ihre KI-Sichtbarkeits-Audits automatisieren, die Ergebnisse in Ihr internes Dashboard integrieren oder AILabsAudit mit Ihren bestehenden Tools verbinden? Die REST-API v1 ist genau dafür gemacht. Dieser Praxisleitfaden begleitet Sie von der ersten Anfrage bis zu fortgeschrittenen Integrationsmustern.
Warum die REST-API von AILabsAudit integrieren?
Die Weboberfläche von AILabsAudit ist ideal für die manuelle Nutzung, stößt aber an ihre Grenzen, wenn Sie Dutzende von Kunden verwalten oder Workflows automatisieren müssen. Die REST-API eröffnet Möglichkeiten, die die Oberfläche nicht bieten kann:
- Vollständige Automatisierung: Starten Sie geplante Audits über Cron-Jobs oder CI/CD-Workflows
- Dashboard-Integration: Zeigen Sie KI-Sichtbarkeitswerte direkt in Ihrem Reporting-Tool an
- Personalisierte Benachrichtigungen: Erkennen Sie Sichtbarkeitsrückgänge und benachrichtigen Sie automatisch Ihre Teams
- Maßgeschneiderte Berichte: Kombinieren Sie AILabsAudit-Daten mit Ihren eigenen Metriken für angereicherte Berichte
- CRM-Synchronisierung: Verknüpfen Sie Auditdaten mit Ihren Kundendatensätzen im CRM
Was Sie mit der API tun können
Kundenverwaltung
Greifen Sie über den Endpoint /api/v1/clients auf Ihr gesamtes Kundenportfolio zu. Rufen Sie Details, Kontakte, Wettbewerber und die vollständige 360°-Ansicht jedes Kunden ab.
Audits und Ergebnisse
Starten Sie neue Audits programmatisch mit POST /api/v1/audits/launch, verfolgen Sie den Fortschritt und rufen Sie detaillierte Ergebnisse ab: Sichtbarkeitswerte, Performance pro KI-Modell, Trends und Vergleiche.
PDF-Berichte
Laden Sie Premium-PDF-Berichte über GET /api/v1/reports/{id}/download herunter, um sie in Ihre automatisierten Kundenlieferungs-Workflows zu integrieren.
Analytics und Portfolio
Greifen Sie auf erweiterte Analytics zu: Portfolioübersicht, Sichtbarkeitsranking, Scoreverteilung. Ideal zum Aufbau von Multi-Client-Tracking-Dashboards.
Schnellstart in 3 Schritten
Schritt 1: API-Schlüssel erstellen
Gehen Sie zu Konto → API & Integrationen und erstellen Sie einen neuen Schlüssel. Er beginnt mit aila_.
Schritt 2: Verbindung testen
Erste Anfrage
curl -H "X-Api-Key: aila_ihr_schluessel" https://ailabsaudit.com/api/v1/clientsWenn Sie die Liste Ihrer Kunden als JSON sehen, funktioniert alles!
Schritt 3: Endpoints erkunden
Lesen Sie das vollständige REST-API-Tutorial, um die 8 Endpoint-Gruppen zu entdecken, oder erkunden Sie direkt die Swagger-Dokumentation.
Gängige Integrationsmuster
Automatische geplante Audits
Der beliebteste Anwendungsfall: Ein Cron-Job, der in regelmäßigen Abständen (wöchentlich oder monatlich) für jeden Kunden ein Audit startet, die Ergebnisse abruft und in Ihrer Datenbank speichert.
# Beispiel: Monatliches Audit für alle Kunden
import requests
API_KEY = "aila_ihr_schluessel"
BASE = "https://ailabsaudit.com/api/v1"
headers = {"X-Api-Key": API_KEY}
clients = requests.get(f"{BASE}/clients", headers=headers).json()
for client in clients["data"]:
requests.post(f"{BASE}/audits/launch",
headers=headers,
json={"client_id": client["id"]})
Dashboard-Einbettung
Integrieren Sie Sichtbarkeitswerte in Ihr eigenes Dashboard, indem Sie den Analytics-Endpoint aufrufen:
scores = requests.get(f"{BASE}/analytics/leaderboard", headers=headers).json()
# In Ihrer Oberfläche anzeigenBenachrichtigungen bei Sichtbarkeitsrückgang
Vergleichen Sie die Werte zwischen zwei aufeinanderfolgenden Audits und senden Sie eine Benachrichtigung (E-Mail, Slack), wenn ein Kunde mehr als 10 Punkte verliert:
audit_history = requests.get(
f"{BASE}/audits?client_id=42&per_page=2",
headers=headers
).json()
# Scores vergleichen und bei Bedarf benachrichtigenBest Practices
Rate-Limiting beachten
Die API erlaubt 60 Anfragen pro Minute pro Schlüssel. Verteilen Sie Ihre Aufrufe zeitlich und implementieren Sie ein exponentielles Backoff bei 429-Fehlern. Prüfen Sie die X-RateLimit-*-Header, um Ihren Verbrauch zu überwachen.
Antworten zwischenspeichern
Auditdaten ändern sich nicht häufig. Cachen Sie Antworten (Redis, lokale Datei) für 1 bis 24 Stunden, um API-Aufrufe zu reduzieren und die Performance Ihrer Anwendung zu verbessern.
Fehler sauber behandeln
Die API gibt Standard-HTTP-Codes und Fehlermeldungen als JSON zurück. Behandeln Sie mindestens die Fälle 401 (ungültiger Schlüssel), 429 (Rate-Limit) und 500 (Serverfehler).
Schlüssel sichern
Speichern Sie Ihren API-Schlüssel in einer Umgebungsvariable, niemals in Ihrem Quellcode. Verwenden Sie verschiedene Schlüssel je Umgebung (Dev/Produktion) und widerrufen Sie einen kompromittierten Schlüssel sofort.
Nützliche Ressourcen
Weiterführende Informationen
Erkunden Sie diese Ressourcen, um die REST-API zu meistern:
- Vollständiges REST-API-Tutorial — Schritt-für-Schritt-Anleitung mit Codebeispielen
- Swagger-Dokumentation — Interaktive Referenz aller Endpoints
- Glossar: REST-API — Definition und Schlüsselkonzepte
- MCP-Leitfaden — Verbinden Sie Ihre KI direkt mit AILabsAudit
FAQ
Welches Abonnement benötige ich für den REST-API-Zugang?
Die REST-API ist mit den Enterprise- und Partner-Plänen verfügbar. Kostenlose und Standard-Pläne beinhalten keinen API-Zugang. Fordern Sie einen Partnerzugang an, um loszulegen.
Verwendet die REST-API die gleichen Schlüssel wie MCP?
Ja, es ist der gleiche API-Schlüssel (Format aila_...). Sie können ihn sowohl für REST-Aufrufe als auch für MCP-Verbindungen verwenden. Erstellen Sie ihn unter API & Integrationen.
Was ist das Anfragelimit?
60 Anfragen pro Minute pro API-Schlüssel. Die Antwort-Header (X-RateLimit-Remaining) zeigen Ihnen Ihren Verbrauch in Echtzeit an.
Kann ich Audits über die API starten?
Ja, der Endpoint POST /api/v1/audits/launch ermöglicht es, Audits programmatisch zu starten. Sie können die Kosten in Credits vorab schätzen und den Auditfortschritt verfolgen.
Gibt es ein offizielles SDK?
Noch nicht, aber das REST-API-Tutorial enthält vollständige Beispiele in Python, JavaScript und PHP, die Sie als Basis verwenden können. Ein offizielles SDK ist in Entwicklung.
Fazit
Die REST-API von AILabsAudit ist der Schlüssel, um von der manuellen Nutzung zur vollständigen Automatisierung Ihrer KI-Sichtbarkeits-Audits überzugehen. Ob Sie wiederkehrende Audits planen, Scores in Ihr Dashboard integrieren oder personalisierte Benachrichtigungen erstellen möchten — die API gibt Ihnen die Werkzeuge dafür.
Bereit zur Automatisierung?
