OLAB Assist REST-API

Was du bekommst

• Endpunkte für Account, Websites, Website-Details, Ergebnisse, KI-Antworten, Score-Verlauf und Änderungen.
• Websites lassen sich über ID oder Domain ansprechen, z. B. /sites/yourbrand.example.
• Paginierung mit next_cursor, 120 Anfragen pro Minute und Schlüssel.
• Ein versionierter Vertrag: Innerhalb von v1 kommen nur Felder hinzu, keine werden entfernt oder umbenannt.

Bevor du startest

• Ein OLAB Assist-Account im Paket Agency, angemeldet als Account-Inhaber.
• Ein Tool, das HTTP-Anfragen mit Header senden kann (curl, Postman, dein CRM, ein Skript).

Schritt für Schritt einrichten

1. 1

   Schlüssel erstellen

   Integrationen → API-Schlüssel: Benenne den Schlüssel nach dem Tool (z. B. „HubSpot-Sync“) und klick auf Schlüssel erstellen. Kopiere ihn sofort; er wird nur einmal angezeigt.

2. 2

   Erste Anfrage senden

   Sende den Schlüssel im Header Authorization. Das Beispiel unten listet deine Websites mit ihren neuesten Scores auf.

3. 3

   Benötigte Daten wählen

   Nutze /sites/{site} für das Gesamtbild, /findings für Probleme, /answers für KI-Antworten und /history für Scores im Zeitverlauf. Die vollständige Referenz steht in der Entwicklerdokumentation.

4. 4

   Einplanen

   Führe deinen Import täglich oder nach jedem Webhook scan.completed aus, damit du nie öfter abfragst als nötig.

curl https://api.olabassist.com/api/v1/sites \
  -H "Authorization: Bearer olab_YOUR_KEY"

Tips

• Ein Schlüssel pro Integration: Ein Widerruf betrifft nur dieses Tool.
• Ignoriere Felder, die du nicht kennst. Mit der Zeit kommen neue hinzu, und dein Code funktioniert weiter.
• Für Google Sheets genügt ein Apps Script mit UrlFetchApp und einem täglichen Trigger.

Troubleshooting

Questions