Zum Inhalt springen

Dokumentation

API-Dokumentation

Übersicht aller 25 API-Endpunkte von Spotlight Service. Jeder Endpunkt hat Rate-Limiting und Error-Handling.

POST/api/free-checkKeine▼

Startet einen kostenlosen Google-Profil-Check. Gibt eine Score-Bewertung und Verbesserungsvorschläge zurück.

Request Body

{
  "businessName": "Frisör Müller",
  "city": "Essen",
  "branch": "friseur"
}

Response

{
  "id": "abc123",
  "score": 42,
  "maxScore": 100,
  "suggestions": [
    "Öffnungszeiten ergänzen",
    "Mehr Fotos hochladen"
  ]
}
GET/api/free-check/pdfKeine▼

Generiert ein PDF des Free-Check-Ergebnisses.

POST/api/free-check/shareKeine▼

Erstellt einen teilbaren Link für ein Free-Check-Ergebnis.

POST/api/contactKeine▼

Sendet eine Kontaktanfrage. Wird als Lead gespeichert.

Request Body

{
  "name": "Max Mustermann",
  "email": "max@example.com",
  "business": "Bäckerei Schmidt",
  "message": "Interesse am Komplett-Setup"
}

Response

{
  "success": true,
  "leadId": "lead_123"
}
POST/api/analyticsKeine▼

Empfängt Analytics-Events (Free-Check, CTA-Klicks, CWV-Metriken etc.).

POST/api/chatKeine▼

Chatbot-Endpunkt. Nimmt eine Nutzer-Nachricht und gibt eine KI-Antwort zurück.

Request Body

{
  "message": "Was kostet das Komplett-Setup?"
}
POST/api/chat-feedbackKeine▼

Feedback zum Chatbot (👍/👎).

POST/api/checkoutKeine▼

Initiiert einen Stripe-Checkout für ein Paket.

POST/api/webhook/stripeStripe Signature▼

Webhook für Stripe-Events (z.B. checkout.session.completed).

GET/api/leads/exportDashboard▼

Exportiert alle Leads als CSV-Datei.

POST/api/leads/update-statusDashboard▼

Aktualisiert den Status eines Leads (Neu, Kontaktiert, Qualifiziert, Gewonnen, Verloren).

Request Body

{
  "leadId": "lead_123",
  "status": "Kontaktiert"
}
POST/api/lead-magnetKeine▼

E-Mail-Optin für Lead-Magnets (Checkliste, Guide etc.).

Request Body

{
  "email": "test@example.com",
  "magnet": "bewertungs-checkliste"
}
GET/api/outreach/referral-linkDashboard▼

Generiert einen Empfehlungslink für einen Outreach-Target.

GET/api/outreach/whatsapp-linkDashboard▼

Generiert einen vorausgefüllten WhatsApp-Link für einen Target.

POST/api/outreach/pre-checkDashboard▼

Führt einen Vorab-Check für einen Outreach-Target durch.

GET/api/dashboard/reportDashboard▼

Generiert einen Dashboard-Bericht (PDF).

GET/api/pricing-pdfKeine▼

Generiert ein Preis-PDF.

GET/api/healthKeine▼

Health-Check-Endpunkt. Gibt Status 200 zurück.

GET/api/cron/digestCron Secret▼

Cron: Wöchentlicher Digest. Aggregiert Leads und sendet Zusammenfassung.

GET/api/cron/recheckCron Secret▼

Cron: Re-Check-Erinnerung für bestehende Leads.

GET/api/cron/sms-reminderCron Secret▼

Cron: SMS-Erinnerung (Platzhalter).

POST/api/auth/connectSession▼

OAuth-Connect für Drittanbieter.

GET/api/auth/callbackOAuth Provider▼

OAuth-Callback-Endpunkt.

GET/api/og/branchKeine▼

Dynamische OG-Bild-Generierung für Branchen-Seiten.

GET/api/og/free-checkKeine▼

Dynamische OG-Bild-Generierung für Free-Check-Ergebnisse.