Spam-Check-API.

Leg per REST einen Spam-Test an, schick deine E-Mail an die zurückgegebene Adresse und lies einen Score von 0 bis 100 samt allen Checks dahinter als JSON aus.

curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# liefert die Test-ID und die Adresse zum Senden
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# sende deine E-Mail an diese Adresse und lies dann das Ergebnis
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# Antwort (200)
{
  "status": "completed",
  "score": 85,
  "sender": "you@yourdomain.com",
  "sender_ip": "192.0.2.1",
  "results": [
    { "id": "spf", "value": [ ... ] },
    { "id": "dkim", "value": [ ... ] },
    { "id": "ip_blacklist", "value": [ ... ] }
  ],
  "report_url": "https://unspam.email/results/2Bl8rzTFN6VV"
}
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV/heatmap \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# Antwort (200)
{
  "focus": { "desktop": { "url": "https://…/focus.png", "status": "completed" } },
  "attention": { "desktop": { "url": null, "status": "pending" } }
}
Endpoints
6
Check-Typen pro Test
17
Authentifizierung
Bearer-Token
Rate-Limit
100 pro Minute

Warum Teams Unspam als ihre Spam-Check-API einsetzen.

Asynchron: erst anlegen, dann lesen.

POST legt einen Test an und gibt eine eindeutige Inbox-Adresse zurück. Schick deine echte E-Mail aus deiner bestehenden Infrastruktur dorthin und hol das Ergebnis per GET. So wird die Nachricht bewertet, die deine Plattform wirklich versendet.

Score von 0 bis 100 plus Absender- und Auth-Details.

Jeder abgeschlossene Test liefert den Score, den Absender-Host, die Absender-IP, die message-ID und ein results[]-Array mit 17 Check-Typen, von SPF, DKIM und DMARC bis zu Blacklists, SpamAssassin und defekten Links. Ein Lesevorgang deckt das komplette Ergebnis ab.

Screenshots, Client-Vorschauen und KI-Heatmaps inklusive.

/screenshots liefert Renderings des Tests für Desktop, Tablet und Mobilgerät, /heatmap KI-Karten zu Fokus und Aufmerksamkeit für Desktop. Übergib dieselbe Test-ID an POST /client-previews, um die E-Mail in über 60 echten Clients und Geräten zu rendern.

Jeder API-Test, gelistet und paginiert.

GET /spam-check?page=N&per_page=15 liefert die laufenden und abgeschlossenen Tests, die du über die API angelegt hast, mit ID, Status, Score, Zeitstempeln und der gehosteten report_url. Zeig frühere Ergebnisse in deinem eigenen Dashboard, ohne den Test zu wiederholen.

Was jeder Spam-Test zurückgibt.

Ein Zustellbarkeits-Score von 0 bis 100, die Aufschlüsselung pro Check dahinter und visuelle sowie KI-Extras für deine QA-Pipelines.

Ein einziger Score von 0 bis 100 für die Zustellbarkeit.

Das Feld score ist eine ganze Zahl von 0 bis 100, die jedes Signal (Authentifizierung, Inhalt, Blacklists, Header) zu einer Zahl zusammenfasst, an der ein CI-Schritt verzweigen kann. Die Berichte von Unspam lesen 90 bis 100 als ausgezeichnet, 70 bis 89 als solide, 50 bis 69 als gefährdet und 0 bis 49 als hohes Risiko und werten einen fehlgeschlagenen SPF-, DKIM- oder DMARC-Check unabhängig von der Zahl als hohes Risiko. Verzweige also auch anhand von results[].

Kombiniere das mit report_url, wenn dein Team die komplette visuelle Aufschlüsselung braucht: Beide Felder kommen in derselben Response.

Posteingang
85/100
0: Spam 100: sauber

Die Aufschlüsselung pro Check im selben Payload.

Das Array results[] listet jeden Check auf, den die Engine ausgeführt hat: spf, dkim, dmarc, bimi, ip_blacklist, domain_blacklist, spamassassin, subject_line, html_best_practice, broken_links und mehr. Jeder Eintrag hat eine stabile id und die Signale dahinter, jedes mit eigenem status.

Kein separater Endpoint für die Ergebnisse der einzelnen Checks. Ein GET, die ganze Geschichte.

  • SPF-Check spf
  • DKIM-Check dkim
  • DMARC-Check dmarc
  • Betreffzeile subject_line
  • Defekte Links broken_links
  • HTML-Best-Practices html_best_practice

Screenshots und KI-Heatmaps im selben Test.

GET /spam-check/{id}/screenshots liefert Bild-URLs deiner E-Mail für Desktop, Tablet und Mobilgerät, mit null für Geräte, die noch laufen. Leg sie ohne weitere Verarbeitung in deinen CI-Artefakten oder deinem Absender-Dashboard ab.

GET /spam-check/{id}/heatmap liefert KI-generierte Heatmaps zu Fokus und Aufmerksamkeit für Desktop, jeweils mit url und status. So siehst du, wohin deine Leser schauen, bevor du den nächsten Versand startest.

Desktop
Tablet
Mobil

So funktioniert die API in vier Schritten.

Die Spam-Check-API arbeitet asynchron: Du legst einen Test an, schickst deine E-Mail an die Adresse, die wir zurückgeben, und liest dann das Ergebnis.

  1. 01

    Spam-Test anlegen

    POST /ext/v2/spam-check mit deinem Bearer-Token. Die 201-Response gibt eine Test-id und eine eindeutige inbox_address zurück.

  2. 02

    E-Mail an die Test-Adresse schicken

    Aus deiner transaktionalen Pipeline, deiner Marketing-Plattform oder einem CI-Schritt. Die Nachricht läuft durch unsere Spam-Check-Engine, die sie zur Analyse festhält.

  3. 03

    Ergebnis auslesen

    GET /ext/v2/spam-check/{id} wechselt von pending_inbox_message über spam_check_running zu completed, mit Score, Absenderdaten und results[]. Frag mit Back-off ab oder häng es an einen Job-Worker, und brich auch bei error oder outdated ab.

  4. 04

    Screenshots, Vorschauen und Heatmaps holen (optional)

    /spam-check/{id}/screenshots für die drei Geräte-Renderings, /spam-check/{id}/heatmap für KI-Karten zu Fokus und Aufmerksamkeit auf Desktop und POST /client-previews mit derselben Test-ID für die E-Mail in über 60 echten Clients (siehe die E-Mail-Vorschau-API). Jedes davon zehrt von einem eigenen Kontingent: Screenshots und Heatmap kosten beim ersten Abruf eine Einheit, und eine Vorschau-Anfrage kostet eine Gerätevorschau pro gerendertem Gerät. Rufst du die Heatmap vor den Screenshots ab, kostet das auch eine Screenshot-Einheit, weil die Heatmap auf dem Desktop-Screenshot entsteht.

Die Endpoints dahinter.

6 Endpoints, mit demselben Token wie die restliche API. Im OpenAPI-Dokument stehen alle Parameter und Response-Codes.

OpenAPI-Dokument
Spam Check 5 Aufrufe
  • GET /spam-check
  • POST /spam-check
  • GET /spam-check/{id}
  • GET /spam-check/{id}/heatmap
  • GET /spam-check/{id}/screenshots
Account 1 Aufruf
  • GET /status

Häufige Fragen zur API.

Integration, Abrechnung, Rate Limits und was der Spam-Check-Endpoint zurückgibt.

Wie bekomme ich API-Zugang?
API-Zugang ist im individuellen Plan enthalten, den du online buchst: Wähle auf der Preisseite das monatliche Volumen jedes Tests, ab einem Mindestbetrag von $5, und die Preise sinken, wenn du wächst. Du kannst ihn in dein eigenes Produkt einbauen und unter deiner eigenen Marke weiterverkaufen. Für alles andere eröffne ein Support-Ticket.
Wie sehen die Rate Limits aus?
Das öffentliche Limit liegt bei 100 Requests pro Minute pro IP oder pro authentifiziertem Konto. Das deckt den meisten Produktions-Traffic ab. Wenn du ein höheres Limit brauchst, eröffne ein Support-Ticket und nenne deinen erwarteten Durchsatz.
Wie läuft der Ablauf aus Anlegen und Lesen ab?
Zwei Aufrufe. POST /ext/v2/spam-check gibt eine inbox_address zurück, deine Versandplattform stellt die echte E-Mail an diese Adresse zu, und GET /ext/v2/spam-check/{id} liefert dann das Ergebnis, sobald status auf completed steht. Frag mit exponentiellem Back-off ab oder nutze einen Job-Worker, und brich auch bei error oder outdated ab.
Kann ich mein verbleibendes Limit über die API abfragen?
GET /ext/v2/status liefert deine E-Mail-Adresse und dein Abo: Tarifname, Preis, nächstes Zahlungsdatum und die verbleibenden Limits (spam_checks, inbox_placements, screenshots, heatmaps, client_previews), dazu die Flags has_history, has_ai_assistant, has_api und has_mcp. Praktisch, um die Nutzung in deiner eigenen Admin-Oberfläche anzuzeigen.
Wie genau ist der Spam-Score?
Der Score zeigt, wie unsere Checks die Nachricht bewerten. Die tatsächliche Zustellung hängt weiter von Versandreputation, Listenhygiene und Empfänger-Engagement ab. Die API liefert dir das Signal zu Inhalt und Authentifizierung, keine Garantie für die Inbox Placement.
Kann ich die API aus jeder Sprache aufrufen?
Ja. Die API ist REST + JSON über HTTPS. Jeder HTTP-Client funktioniert (curl, Node, Python, Go, Ruby, PHP, …). Kein Pflicht-SDK; die Authentifizierung ist ein einziger Header Authorization: Bearer YOUR_API_TOKEN.
Gibt es eine Sandbox oder eine kostenlose Testphase?
Eine API-Sandbox gibt es nicht. Der Free-Plan führt dieselben Tests im Dashboard aus, sodass du die Ergebnisse beurteilen kannst, bevor du zahlst, und der individuelle Plan beginnt bei $5 im Monat mit einer 14-tägigen Geld-zurück-Garantie. Ein echter API-Pilot ist also günstig auszuprobieren.
Kann ich das in mein eigenes Produkt einbauen und weiterverkaufen?
Ja, mit dem individuellen Plan. Jeder Spam-Test kommt als JSON mit seinem Score und den Ergebnissen jeder einzelnen Prüfung zurück, sodass du ihn in deiner eigenen Oberfläche zeigen und unter deiner eigenen Marke an deine Kunden weiterverkaufen kannst.

Bereit, Unspam in deinen Stack zu integrieren?

API-Zugang ist im individuellen Plan enthalten, den du online ab einem Mindestbetrag von $5 im Monat buchst. Bau ihn in dein eigenes Produkt ein und verkauf ihn unter deiner eigenen Marke weiter.