Analytics & Reporting

Overview

EuroMail records what happens to every email and exposes it through the /v1/analytics endpoints and the dashboard. Use it to answer the questions that matter: are my emails landing, are people engaging, and is anything hurting my reputation?

For the full endpoint reference, see the Analytics API reference.

The headline numbers

curl "https://api.euromail.dev/v1/analytics/overview" \
  -H "X-EuroMail-Api-Key: em_live_your_key_here"

The overview returns counts and rates for a period: sent, delivered, opened, clicked, bounced, and complained. The two rates to watch closest are:

• Bounce rate. Keep it low (a few percent). A rising bounce rate means list hygiene problems; see Suppressions.
• Complaint rate. Keep it well under 0.1%. Complaints are the fastest way to lose inbox placement.

Trends over time

curl "https://api.euromail.dev/v1/analytics/timeseries?interval=day" \
  -H "X-EuroMail-Api-Key: em_live_your_key_here"

The timeseries breaks the same metrics into buckets so you can chart them and spot a regression the day it starts. A deploy that broke a template, a domain whose DKIM expired, a campaign that drew complaints.

Breakdown by recipient domain

curl "https://api.euromail.dev/v1/analytics/domains" \
  -H "X-EuroMail-Api-Key: em_live_your_key_here"

Delivery is not uniform across mailbox providers. The per-domain breakdown shows how you perform at Gmail vs. Outlook vs. corporate servers, so you can tell a provider-specific block (e.g. only Gmail bouncing) from a general problem.

Breakdown by tag

If you tag your sends (auth, billing, marketing), you can compare streams against each other:

curl "https://api.euromail.dev/v1/analytics/tags" \
  -H "X-EuroMail-Api-Key: em_live_your_key_here"

This is how you confirm that, say, your transactional mail has near-100% delivery while diagnosing a weaker marketing stream separately.

CSV export

For ad-hoc analysis in a spreadsheet or your own warehouse:

curl "https://api.euromail.dev/v1/analytics/export" \
  -H "X-EuroMail-Api-Key: em_live_your_key_here" \
  -o euromail-analytics.csv

Per-email engagement

For a single email, fetch its status and the rewritten tracked links to see exactly which URLs were clicked:

curl https://api.euromail.dev/v1/emails/{id}/links \
  -H "X-EuroMail-Api-Key: em_live_your_key_here"

Real-time vs. aggregate

Analytics endpoints give you the aggregate picture. For real-time reaction. updating your own database the instant an email is delivered, opened, bounced, or complained about. Subscribe to Webhooks instead of polling these endpoints.

Going deeper on deliverability

Analytics tells you what happened. To understand why and get specific remediation (SPF/DKIM/DMARC alignment, blocklist status, reputation trends), use Deliverability Insights and DMARC Monitoring.