Analytics

Overview

Track email performance with built-in analytics. The platform automatically records opens, clicks, bounces, and unsubscribes for every email sent. Use the analytics endpoints to retrieve aggregate statistics, per-contact engagement scores, and AI-powered send time recommendations.

Dashboard Stats

Retrieve high-level statistics for your account including total contacts, emails sent, and engagement rates. These are the same numbers displayed on the main dashboard.

{
  "total_contacts": 1248,
  "total_emails": 8420,
  "sent_today": 64,
  "open_rate": 42.5,
  "click_rate": 12.8,
  "bounce_rate": 1.3
}

Engagement Scores

Each contact is assigned an engagement score based on their recent activity. Scores are broken into tiers — hot, warm,cooling, cold, and new — so you can target your most engaged subscribers or re-engage inactive ones.

{
  "contacts": [
    {
      "email": "jane@example.com",
      "name": "Jane Doe",
      "score": 87,
      "tier": "hot",
      "opens_30d": 14,
      "clicks_30d": 6
    },
    {
      "email": "bob@example.com",
      "name": "Bob Smith",
      "score": 32,
      "tier": "cooling",
      "opens_30d": 3,
      "clicks_30d": 0
    }
  ]
}

Send Time Optimization

The AI-powered send time optimization endpoint analyzes historical engagement data to recommend the best time to send emails to each contact. Use these recommendations when scheduling campaigns for maximum open and click rates.

{
  "recommendations": [
    {
      "email": "jane@example.com",
      "optimal_hour_utc": 14,
      "optimal_day": "tuesday",
      "confidence": 0.89
    },
    {
      "email": "bob@example.com",
      "optimal_hour_utc": 9,
      "optimal_day": "thursday",
      "confidence": 0.72
    }
  ]
}

Tracking Events

Opens are tracked via a transparent 1x1 pixel embedded in every outgoing email. When a recipient loads the image, a request is made to /api/track/open which logs the event with the email ID and timestamp.

Clicks are tracked via link rewriting. All links in outgoing emails are replaced with redirect URLs pointing to /api/track/click. When a recipient clicks a link, the event is logged and the user is immediately redirected to the original destination.

Both tracking endpoints are fully automatic — no additional configuration is required. Events are stored in the email_events table and aggregated into the statistics returned by the dashboard and engagement endpoints.