Praxisleitfaden AILabsAudit REST-API: Automatisieren Sie Ihre KI-Sichtbarkeits-Audits

<p class="lead">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.</p> <h2>Warum die REST-API von AILabsAudit integrieren?</h2> <p>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:</p> <ul> <li><strong>Vollständige Automatisierung</strong>: Starten Sie geplante Audits über Cron-Jobs oder CI/CD-Workflows</li> <li><strong>Dashboard-Integration</strong>: Zeigen Sie KI-Sichtbarkeitswerte direkt in Ihrem Reporting-Tool an</li> <li><strong>Personalisierte Benachrichtigungen</strong>: Erkennen Sie Sichtbarkeitsrückgänge und benachrichtigen Sie automatisch Ihre Teams</li> <li><strong>Maßgeschneiderte Berichte</strong>: Kombinieren Sie AILabsAudit-Daten mit Ihren eigenen Metriken für angereicherte Berichte</li> <li><strong>CRM-Synchronisierung</strong>: Verknüpfen Sie Auditdaten mit Ihren Kundendatensätzen im CRM</li> </ul> <h2>Was Sie mit der API tun können</h2> <h3>Kundenverwaltung</h3> <p>Greifen Sie über den Endpoint <code>/api/v1/clients</code> auf Ihr gesamtes Kundenportfolio zu. Rufen Sie Details, Kontakte, Wettbewerber und die vollständige 360°-Ansicht jedes Kunden ab.</p> <h3>Audits und Ergebnisse</h3> <p>Starten Sie neue Audits programmatisch mit <code>POST /api/v1/audits/launch</code>, verfolgen Sie den Fortschritt und rufen Sie detaillierte Ergebnisse ab: Sichtbarkeitswerte, Performance pro KI-Modell, Trends und Vergleiche.</p> <h3>PDF-Berichte</h3> <p>Laden Sie Premium-PDF-Berichte über <code>GET /api/v1/reports/{id}/download</code> herunter, um sie in Ihre automatisierten Kundenlieferungs-Workflows zu integrieren.</p> <h3>Analytics und Portfolio</h3> <p>Greifen Sie auf erweiterte Analytics zu: Portfolioübersicht, Sichtbarkeitsranking, Scoreverteilung. Ideal zum Aufbau von Multi-Client-Tracking-Dashboards.</p> <h2>Schnellstart in 3 Schritten</h2> <h3>Schritt 1: API-Schlüssel erstellen</h3> <p>Gehen Sie zu <a href="/account/api-integrations"><strong>Konto → API & Integrationen</strong></a> und erstellen Sie einen neuen Schlüssel. Er beginnt mit <code>aila_</code>.</p> <h3>Schritt 2: Verbindung testen</h3> <div class="callout callout-info"> <h4>Erste Anfrage</h4> <pre><code>curl -H "X-Api-Key: aila_ihr_schluessel" https://ailabsaudit.com/api/v1/clients</code></pre> <p>Wenn Sie die Liste Ihrer Kunden als JSON sehen, funktioniert alles!</p> </div> <h3>Schritt 3: Endpoints erkunden</h3> <p>Lesen Sie das <a href="/tutoriel/fr/api-rest"><strong>vollständige REST-API-Tutorial</strong></a>, um die 8 Endpoint-Gruppen zu entdecken, oder erkunden Sie direkt die <a href="/api/v1/docs"><strong>Swagger-Dokumentation</strong></a>.</p> <h2>Gängige Integrationsmuster</h2> <h3>Automatische geplante Audits</h3> <p>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.</p> <pre><code># 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"]}) </code></pre> <h3>Dashboard-Einbettung</h3> <p>Integrieren Sie Sichtbarkeitswerte in Ihr eigenes Dashboard, indem Sie den Analytics-Endpoint aufrufen:</p> <pre><code>scores = requests.get(f"{BASE}/analytics/leaderboard", headers=headers).json() # In Ihrer Oberfläche anzeigen</code></pre> <h3>Benachrichtigungen bei Sichtbarkeitsrückgang</h3> <p>Vergleichen Sie die Werte zwischen zwei aufeinanderfolgenden Audits und senden Sie eine Benachrichtigung (E-Mail, Slack), wenn ein Kunde mehr als 10 Punkte verliert:</p> <pre><code>audit_history = requests.get( f"{BASE}/audits?client_id=42&per_page=2", headers=headers ).json() # Scores vergleichen und bei Bedarf benachrichtigen</code></pre> <h2>Best Practices</h2> <h3>Rate-Limiting beachten</h3> <p>Die API erlaubt <strong>60 Anfragen pro Minute</strong> pro Schlüssel. Verteilen Sie Ihre Aufrufe zeitlich und implementieren Sie ein exponentielles Backoff bei 429-Fehlern. Prüfen Sie die <code>X-RateLimit-*</code>-Header, um Ihren Verbrauch zu überwachen.</p> <h3>Antworten zwischenspeichern</h3> <p>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.</p> <h3>Fehler sauber behandeln</h3> <p>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).</p> <h3>Schlüssel sichern</h3> <p>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.</p> <h2>Nützliche Ressourcen</h2> <div class="info-box" style="background: linear-gradient(135deg, #10b98115 0%, #3b82f615 100%); border-left: 4px solid #10b981; padding: 20px; margin: 2rem 0; border-radius: 0 12px 12px 0;"> <h4 style="margin-top: 0; color: #1e293b;">Weiterführende Informationen</h4> <p style="margin-bottom: 1rem;">Erkunden Sie diese Ressourcen, um die REST-API zu meistern:</p> <ul style="margin: 0;"> <li><a href="/tutoriel/fr/api-rest"><strong>Vollständiges REST-API-Tutorial</strong></a> — Schritt-für-Schritt-Anleitung mit Codebeispielen</li> <li><a href="/api/v1/docs"><strong>Swagger-Dokumentation</strong></a> — Interaktive Referenz aller Endpoints</li> <li><a href="/glossaire/de/api-rest"><strong>Glossar: REST-API</strong></a> — Definition und Schlüsselkonzepte</li> <li><a href="/tutoriel/fr/guide-mcp"><strong>MCP-Leitfaden</strong></a> — Verbinden Sie Ihre KI direkt mit AILabsAudit</li> </ul> </div> <h2>FAQ</h2> <div class="faq-section"> <div class="faq-item"> <h4>Welches Abonnement benötige ich für den REST-API-Zugang?</h4> <p>Die REST-API ist mit den Enterprise- und Partner-Plänen verfügbar. Kostenlose und Standard-Pläne beinhalten keinen API-Zugang. <a href="/partner-request">Fordern Sie einen Partnerzugang an</a>, um loszulegen.</p> </div> <div class="faq-item"> <h4>Verwendet die REST-API die gleichen Schlüssel wie MCP?</h4> <p>Ja, es ist der gleiche API-Schlüssel (Format <code>aila_...</code>). Sie können ihn sowohl für REST-Aufrufe als auch für MCP-Verbindungen verwenden. Erstellen Sie ihn unter <a href="/account/api-integrations">API & Integrationen</a>.</p> </div> <div class="faq-item"> <h4>Was ist das Anfragelimit?</h4> <p>60 Anfragen pro Minute pro API-Schlüssel. Die Antwort-Header (<code>X-RateLimit-Remaining</code>) zeigen Ihnen Ihren Verbrauch in Echtzeit an.</p> </div> <div class="faq-item"> <h4>Kann ich Audits über die API starten?</h4> <p>Ja, der Endpoint <code>POST /api/v1/audits/launch</code> ermöglicht es, Audits programmatisch zu starten. Sie können die Kosten in Credits vorab schätzen und den Auditfortschritt verfolgen.</p> </div> <div class="faq-item"> <h4>Gibt es ein offizielles SDK?</h4> <p>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.</p> </div> </div> <h2>Fazit</h2> <p>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.</p> <p><strong>Bereit zur Automatisierung?</strong></p> <div class="cta-box"> <a href="/account/api-integrations" class="btn btn-primary btn-lg">Meinen API-Schlüssel erstellen</a> <a href="/tutoriel/fr/api-rest" class="btn btn-outline-primary btn-lg">Das vollständige Tutorial lesen</a> </div>