MailLandDocs
Zustellbarkeit

Zustellbarkeitsübersicht

Überwachen Sie die Absenderreputation, Zustellraten und DNS-Gesundheit über alle Ihre Domains hinweg

MailLand verfolgt Ihre Absenderreputation durch einen zusammengesetzten Score, Zustelltrends, Aufschlüsselungen nach Anbieter und DNS-Zustandsüberwachung. Verwenden Sie die Zustellbarkeits-API, um diese Metriken in Ihren eigenen Dashboards anzuzeigen oder Warnmeldungen auszulösen, wenn die Reputation sinkt.

Absender-Score

Erhalten Sie einen Reputationsscore von 0–100, aufgeteilt in vier gewichtete Komponenten:

GET https://api.mail.land/v1/deliverability/score

Authentifizieren Sie sich mit Authorization: Bearer <token> oder X-API-Key: <api key>.

Get sender score
curl https://api.mail.land/v1/deliverability/score \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Sender score response
{
  "totalScore": 87,
  "label": "Good",
  "hasSufficientData": true,
  "totalSentLast30Days": 142500,
  "dnsScore": {
    "name": "DNS Authentication",
    "score": 25,
    "maxScore": 25,
    "detail": "2/2 domains fully authenticated"
  },
  "bounceScore": {
    "name": "Bounce Rate",
    "score": 20,
    "maxScore": 25,
    "detail": "Bounce rate: 1.80%"
  },
  "complaintScore": {
    "name": "Complaint Rate",
    "score": 25,
    "maxScore": 25,
    "detail": "Complaint rate: 0.020%"
  },
  "engagementScore": {
    "name": "Engagement",
    "score": 25,
    "maxScore": 25,
    "detail": "Open rate: 32.0%"
  },
  "calculatedAt": "2026-02-17T12:00:00Z"
}

Jede Komponente trägt bis zu 25 Punkte bei. Bei weniger als 100 Sendungen in den letzten 30 Tagen ist hasSufficientData gleich false. totalScore wird trotzdem berechnet, ist bei diesem Volumen aber nicht aussagekräftig: Ohne jede Sendung erhalten die Bounce- und Beschwerde-Komponenten jeweils die volle Punktzahl (25), sodass ein brandneues Konto bis zu 75 Punkte anzeigen kann, bevor überhaupt etwas gesendet wurde.

Score-Verlauf

Verfolgen Sie, wie sich Ihr Score im Laufe der Zeit verändert:

GET https://api.mail.land/v1/deliverability/score/history?days=30
Get score history
curl "https://api.mail.land/v1/deliverability/score/history?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParameterTypStandardBeschreibung
daysint30Verlaufsfenster (7–90)
Score history response
[
  {
    "date": "2026-02-17",
    "totalScore": 87,
    "label": "Good",
    "dnsScore": 25,
    "bounceScore": 22,
    "complaintScore": 25,
    "engagementScore": 15,
    "bounceRate": 0.8,
    "complaintRate": 0.02,
    "openRate": 32.0,
    "deliveryRate": 98.5,
    "totalSent": 4750,
    "hasSufficientData": true
  }
]

Zustellbarkeitsstatistiken im Überblick

Aggregierte Zustellmetriken für einen Zeitraum abrufen:

GET https://api.mail.land/v1/deliverability/overview?days=30
Get deliverability overview
curl "https://api.mail.land/v1/deliverability/overview?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParameterTypStandardBeschreibung
daysint30Zeitfenster (wird auf 7, 30 oder 90 normalisiert)
Overview response
{
  "totalSent": 142500,
  "totalDelivered": 140325,
  "totalBounced": 1125,
  "totalComplained": 28,
  "totalOpened": 44878,
  "totalClicked": 5843,
  "totalUnsubscribed": 312,
  "deliveryRate": 98.47,
  "bounceRate": 0.79,
  "complaintRate": 0.02,
  "openRate": 31.49,
  "clickRate": 4.1,
  "unsubscribeRate": 0.22
}

Tägliche Zustellmetriken abrufen, um Trends zu visualisieren:

GET https://api.mail.land/v1/deliverability/trends?days=30
Get daily trends
curl "https://api.mail.land/v1/deliverability/trends?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Trends response (abbreviated)
[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "bounced": 38,
    "complained": 1,
    "opened": 1498,
    "deliveryRate": 98.53,
    "bounceRate": 0.8,
    "complaintRate": 0.02,
    "openRate": 31.53
  }
]

Anbieteraufschlüsselung

Zustellbarkeitsmetriken nach Empfänger-Mailbox-Anbieter (Gmail, Yahoo, Outlook usw.) gruppiert anzeigen:

GET https://api.mail.land/v1/deliverability/providers?days=30&limit=10
Get provider breakdown
curl "https://api.mail.land/v1/deliverability/providers?days=30&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParameterTypStandardBeschreibung
daysint30Zeitfenster (wird auf 7, 30 oder 90 normalisiert)
limitint10Maximale Anzahl zurückzugebender Anbieter (1–50)
Provider breakdown response
[
  {
    "domain": "gmail.com",
    "sent": 58200,
    "delivered": 57800,
    "bounced": 210,
    "opened": 19500,
    "clicked": 2540,
    "complained": 8,
    "deliveryRate": 99.31,
    "openRate": 33.51,
    "bounceRate": 0.36
  },
  {
    "domain": "outlook.com",
    "sent": 31400,
    "delivered": 30800,
    "bounced": 350,
    "opened": 8650,
    "clicked": 1120,
    "complained": 12,
    "deliveryRate": 98.09,
    "openRate": 27.55,
    "bounceRate": 1.11
  }
]

Bounce-Aufschlüsselung

Bounces nach Typ und Ursache kategorisiert anzeigen:

GET https://api.mail.land/v1/deliverability/bounce-breakdown?days=30
Get bounce breakdown
curl "https://api.mail.land/v1/deliverability/bounce-breakdown?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Bounce breakdown response
{
  "hardBounces": 450,
  "softBounces": 625,
  "blockedBounces": 40,
  "unknownBounces": 10,
  "totalBounces": 1125,
  "topReasons": [
    { "reason": "InvalidRecipient", "count": 380 },
    { "reason": "QuotaIssues", "count": 290 },
    { "reason": "SpamBlock", "count": 40 },
    { "reason": "BadDomain", "count": 70 },
    { "reason": "PolicyRelated", "count": 95 },
    { "reason": "TransientFailure", "count": 55 }
  ]
}

topReasons verwendet die eigenen Klassifizierungsnamen der MTA (das vollständige Vokabular finden Sie unter Bounces), nicht die von Schlüsselwörtern abgeleiteten snake_case-Kategorien der transaktionalen Bounce-Endpunkte.

Vollständige Details zu Bounce-Kategorien und Verarbeitungsverhalten finden Sie unter Bounces.

DNS-Status

DNS-Authentifizierungsstatus über alle Ihre Domains hinweg prüfen:

GET https://api.mail.land/v1/deliverability/dns-status
Get DNS status
curl https://api.mail.land/v1/deliverability/dns-status \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
DNS status response
[
  {
    "domainId": "k3v9x2m8q1w7z4",
    "domainName": "yourdomain.com",
    "spfStatus": "Valid",
    "dkimStatus": "Valid",
    "dmarcStatus": "Valid",
    "lastCheckedAt": "2026-02-17T10:00:00Z",
    "isFullyAuthenticated": true
  },
  {
    "domainId": "n7p2q9x4m8w1z3",
    "domainName": "notifications.yourdomain.com",
    "spfStatus": "Valid",
    "dkimStatus": "Valid",
    "dmarcStatus": "Invalid",
    "lastCheckedAt": "2026-02-17T10:00:00Z",
    "isFullyAuthenticated": false
  }
]

Eine Domain ist isFullyAuthenticated, wenn SPF, DKIM und DMARC alle den Status Valid haben.

StatusBeschreibung
PendingEintrag noch nicht überprüft
ValidEintrag korrekt konfiguriert
InvalidEintrag fehlt oder ist falsch konfiguriert

Empfehlungen

Umsetzbare Empfehlungen zur Verbesserung Ihrer Absenderreputation abrufen:

GET https://api.mail.land/v1/deliverability/recommendations
Get recommendations
curl https://api.mail.land/v1/deliverability/recommendations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Recommendations response
[
  {
    "id": "dns_dmarc_missing_notifications.yourdomain.com",
    "category": "dns",
    "severity": "critical",
    "titleKey": "deliverability.recommendations.dns.dmarcMissing.title",
    "descriptionKey": "deliverability.recommendations.dns.dmarcMissing.description",
    "actionUrl": "/domains",
    "impact": 8,
    "parameters": {
      "domain": "notifications.yourdomain.com"
    }
  },
  {
    "id": "bounce_high",
    "category": "bounce",
    "severity": "warning",
    "titleKey": "deliverability.recommendations.bounce.high.title",
    "descriptionKey": "deliverability.recommendations.bounce.high.description",
    "actionUrl": "/deliverability",
    "impact": 15
  }
]
FeldTypBeschreibung
idstringKennung der Empfehlung. Kein stabiles Enum: DNS-IDs enthalten den Domainnamen (z. B. dns_dmarc_missing_{domain}), daher erzeugt dasselbe Problem auf zwei Domains zwei unterschiedliche IDs.
categorystringdns, bounce, complaint, engagement, warmup oder volume
severitystringcritical, warning oder info
impactintPotenzielle Score-Verbesserung (0–100) bei Behebung
actionUrlstringFrontend-Route zur Behebung des Problems: eine von /domains, /deliverability, /suppression-lists, /analytics oder /dashboard
parametersobjectWerte für i18n-Interpolation. Nur bei DNS-Empfehlungen vorhanden ({"domain": "..."}); Bounce-, Beschwerde-, Engagement-, Warmup- und Volumen-Empfehlungen haben kein parameters.

Es werden höchstens 10 Empfehlungen zurückgegeben, sortiert nach Schweregrad (kritisch zuerst) und dann absteigend nach Impact.

Caching

Alle Zustellbarkeits-Endpunkte werden serverseitig zwischengespeichert, um die Abfragelast auf ClickHouse zu reduzieren:

EndpunktCache-TTL
/score15 Minuten
/overview5 Minuten
/trends3 Minuten
/providers5 Minuten
/bounce-breakdown5 Minuten
/score/historyNicht gecacht
/dns-statusNicht gecacht (Echtzeit)
/recommendations10 Minuten

Der Parameter days wird auf 7, 30 oder 90 normalisiert: Werte ≤ 7 werden auf 7 gerundet, 8–30 auf 30, und alles über 30 auf 90. Ein Wert wie 14 wird auf 30 gerundet, nicht auf 7.

Nächste Schritte

DKIM-Schlüsselrotation

DKIM-Signaturschlüssel für Ihre Sendedomain

Bounces

Bounce-Typen, Kategorien, automatische Unterdrückung und Wiederholungsverhalten verstehen

Auf dieser Seite

Absender-ScoreScore-VerlaufZustellbarkeitsstatistiken im ÜberblickTägliche TrendsAnbieteraufschlüsselungBounce-AufschlüsselungDNS-StatusEmpfehlungenCachingNächste Schritte