Analytics Overview

MailLand provides real-time analytics powered by ClickHouse for high-performance aggregation across millions of events. Track deliveries, opens, clicks, bounces, and complaints with flexible date ranges and email type filtering.

Event SummaryCopy Anchor Link

Get aggregate event counts for a period:

GET https://api.mail.land/v1/transactional/analytics/events/summary

curl "https://api.mail.land/v1/transactional/analytics/events/summary?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Query ParametersCopy Anchor Link

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "sent": 142500,
  "delivered": 140325,
  "opened": 44878,
  "clicked": 5843,
  "bounced": 1125,
  "complained": 28,
  "source": "clickhouse",
  "data_source": "clickhouse",
  "is_degraded": false,
  "queryTimeMs": 45
}

Daily StatsCopy Anchor Link

Get per-day event breakdowns for charting:

GET https://api.mail.land/v1/transactional/analytics/stats/daily

curl "https://api.mail.land/v1/transactional/analytics/stats/daily?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "opened": 1498,
    "clicked": 195,
    "bounced": 38
  },
  {
    "date": "2026-02-16T00:00:00Z",
    "sent": 4320,
    "delivered": 4260,
    "opened": 1380,
    "clicked": 175,
    "bounced": 32
  }
]

RatesCopy Anchor Link

Get delivery, open, and click rates calculated as percentages:

GET https://api.mail.land/v1/transactional/analytics/rates

curl "https://api.mail.land/v1/transactional/analytics/rates?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "deliveryRate": 98.47,
  "openRate": 31.49,
  "clickRate": 13.02
}

Rate calculations:

All three rate queries execute in parallel for optimal performance.

Top LinksCopy Anchor Link

See the most clicked links across your emails:

GET https://api.mail.land/v1/transactional/analytics/links/top

curl "https://api.mail.land/v1/transactional/analytics/links/top?from=2026-01-18&to=2026-02-17&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "url": "https://your-app.com/orders/track",
    "clicks": 2340,
    "uniqueRecipients": 1890
  },
  {
    "url": "https://your-app.com/dashboard",
    "clicks": 1150,
    "uniqueRecipients": 980
  }
]

Hourly VolumeCopy Anchor Link

Track sending volume by hour, with optional baseline overlay for anomaly detection:

GET https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7

curl "https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "hour": "2026-02-17T14:00:00Z",
    "sent": 520,
    "baseline": 480.5
  },
  {
    "hour": "2026-02-17T13:00:00Z",
    "sent": 495,
    "baseline": 480.5
  }
]

The baseline is the historical average volume for that hour of day, computed by the VolumeAnomalyWorker. It's null if no baseline data is available yet.

CachingCopy Anchor Link

Analytics endpoints are cached server-side to minimize query load:

The events/summary endpoint coalesces concurrent identical requests per server: only one query hits ClickHouse per API instance, and all callers on that instance receive the same result. The other endpoints on this page do not coalesce; each request reads the cache and then queries.

Data SourcesCopy Anchor Link

MailLand uses ClickHouse as the primary analytics data source for fast aggregation over billions of events.

The source field in responses indicates which data store served the result. The queryTimeMs field helps monitor performance.

RetentionCopy Anchor Link

Analytics event data follows the workspace's plan: logs are kept 30 days on Free, 90 days on Pro, and 180 days on Max.

Next StepsCopy Anchor Link

• Email Logs: search and inspect individual email deliveries
• Advanced Analytics: geographic, device, and time-of-day analytics
• Deliverability Overview: sender reputation and trends