API and webhooks: integrate Luna into your existing stack

Luna isn't an isolated tool — it's an open platform that integrates into your ecosystem.

Complete REST API

Luna's API exposes all your account data:

Main endpoints

• GET /alerts — list your alerts (filters: severity, date, competitor)
• GET /competitors — your monitored competitors with scores
• GET /predictions — active predictions
• GET /battlecards/:id — battlecard content
• POST /scan — trigger a manual scan

Authentication

API key generated in Settings > API. SHA-256 hash stored server-side. Configurable rate limit (default: 1000 req/h).

CSV export

Dedicated endpoints for bulk export:

• GET /export/alerts.csv
• GET /export/competitors.csv
• GET /export/predictions.csv

Real-time webhooks

Get instant notifications when Luna detects something:

Configuration

1. Destination URL (HTTPS required)

2. Secret for HMAC-SHA-256 signature

3. Desired events (alert.created, scan.completed, etc.)

4. Severity filter (optional)

Security

Each payload is signed with X-Luna-Signature: sha256=. Verify the HMAC on the receiver side to guarantee authenticity.

Resilience

• 3 retries with exponential backoff
• Automatic pause after 10 consecutive failures
• Complete delivery logs in the dashboard

Use cases

• Feed a Slack channel on every critical alert
• Trigger an n8n/Zapier workflow to enrich a CRM
• Push predictions to a Tableau/PowerBI dashboard
• Sync battlecards with an internal wiki