API Referenz

Die NexaAds REST API gibt dir programmatischen Zugriff auf alle Funktionen. Hier findest du alle Endpunkte, Parameter und Antwortformate.

Authentifizierung

Alle API-Anfragen müssen einen gültigen API-Schlüssel im Header enthalten:

Rate Limits: 100 Requests pro Minute im Free-Plan, 1.000 im Pro-Plan, unbegrenzt im Enterprise-Plan.

Kampagnen-Endpunkte

• GET /api/v1/campaigns: Alle Kampagnen auflisten. Unterstützt Pagination, Filter nach Status, Plattform und Zeitraum.
• GET /api/v1/campaigns/:id: Details einer einzelnen Kampagne mit allen Metriken.
• PATCH /api/v1/campaigns/:id: Kampagne aktualisieren (Budget, Status, Name).
• POST /api/v1/campaigns/:id/analyze: KI-Analyse für eine Kampagne starten.

Report-Endpunkte

• GET /api/v1/reports: Alle gespeicherten Reports auflisten.
• POST /api/v1/reports: Neuen Report generieren. Parameter: type (daily/weekly/monthly), campaigns (Array von IDs), format (pdf/json).
• GET /api/v1/reports/:id: Report herunterladen oder als JSON abrufen.

Analyse-Endpunkte

• POST /api/v1/analyze/campaign: Umfassende KI-Analyse einer Kampagne.
• POST /api/v1/analyze/creative: Creative-Analyse mit Scores und Empfehlungen.
• POST /api/v1/analyze/audience: Zielgruppen-Analyse mit Überlappungsprüfung.
• GET /api/v1/analyze/:id/status: Status einer laufenden Analyse abfragen.

Webhook-Events

NexaAds kann Webhooks senden, wenn bestimmte Events eintreten:

• analysis.completed: Eine KI-Analyse ist fertig
• campaign.alert: Performance-Warnung für eine Kampagne
• budget.adjusted: Die KI hat Budget verschoben
• report.ready: Ein Report wurde generiert

Konfiguriere Webhooks unter "Einstellungen" im Dashboard.

Nächste Schritte

Im Guide "Automatisierung mit n8n" lernst du, wie du die API in automatisierte Workflows einbindest.