Spam-Check-API.

Leg per REST einen Spam-Test an, schick deine E-Mail an die Adresse, die wir zurückgeben, und lies dann einen Zustellbarkeits-Score von 0 bis 100 aus, mit Absender-Forensik, Aufschlüsselung pro Check, Screenshots und KI-Heatmaps als JSON.

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

# response (201)
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# now send your email to inbox_address
# from your sending platform.
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "id": "2Bl8rzTFN6VV",
  "status": "completed",
  "score": 85,
  "sender": "you@yourdomain.com",
  "sender_ip": "192.0.2.1",
  "results": [
    { "id": "spf_check", ... },
    { "id": "dkim_check", ... },
    { "id": "dmarc_check", ... }
  ],
  "report_url": "https://unspam.email/email-test/2Bl8rzTFN6VV"
}

Vier Request-Typen. Ein API-Key.

Ein Key deckt alle vier Endpoints ab. Starte mit POST /spam-check für Score, Absender-Forensik und die Aufschlüsselung pro Check, und nutze denselben Lauf, um an die Test-Postfächer zu senden, echte Client-Vorschauen zu holen oder die Aufmerksamkeits-Heatmap anzufordern.

Spam-Tests

POST /spam-checkScore, Absender-Forensik, Aufschlüsselung pro Check. Gebaut für Versandplattformen und CRM-Teams.

Inbox Placement

POST /inbox-placementAn unsere Test-Postfächer senden und pro Postfach den Ordner (Posteingang / Werbung / Spam) plus Blacklist-Treffer bekommen.

Client-Vorschauen

GET /spam-check/{id}/client-previewsRendering deiner E-Mail in über 50 echten Clients und auf echten Geräten, hell und dunkel. Mehr dazu bei der E-Mail-Vorschau-API.

E-Mail-Heatmaps

GET /spam-check/{id}/heatmapKI-generierte Heatmaps zu Fokus und Aufmerksamkeit für alle drei Gerätegrößen.

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

Asynchron: erst anlegen, dann lesen.

POST legt einen Test an und gibt eine eindeutige Test-Adresse zurück. Schick deine echte E-Mail aus deiner bestehenden Infrastruktur dorthin und hol dir das Ergebnis danach per GET. Keine Payload-Limits, kein MIME-Gebastel.

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 SPF/DKIM/DMARC und inhaltlichen Checks. Ein Lesevorgang deckt das komplette Ergebnis ab.

Screenshots, Client-Vorschauen und KI-Heatmaps inklusive.

Jeder Spam-Test hat drei Sub-Ressourcen: /screenshots liefert Renderings für Desktop, Tablet und Mobil, /client-previews rendert die E-Mail in über 50 echten Clients und auf echten Geräten, und /heatmap gibt KI-generierte Karten zu Fokus und Aufmerksamkeit für dieselbe E-Mail zurück.

Jeder Test bleibt gespeichert und paginiert.

Frühere Spam-Tests bleiben gespeichert. GET /spam-check?page=N&per_page=15 gibt die paginierte Liste mit id, status, score, Zeitstempeln und der gehosteten report_url zurück. Bau historische Ergebnisse in dein eigenes Dashboard ein, ohne den Test neu zu starten.

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.

01

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

Das Feld score fasst jedes Signal (Authentifizierung, Inhalt, Blacklists, Header) zu einer Zahl zusammen, an der ein CI-Schritt verzweigen kann. Ab 80 ist alles gesund, 50 bis 70 ist riskant, unter 50 landet die E-Mail sehr wahrscheinlich im Spam.

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
02

Die Aufschlüsselung pro Check im selben Payload.

Das Array results[] listet jede Prüfung auf, die die Engine ausgeführt hat: SPF, DKIM, DMARC, BIMI, Dichte der Spam-Wörter, Link-Reputation, Bild-Text-Verhältnis und mehr. Jeder Eintrag hat eine stabile id, die du auf dein eigenes Dashboard mappen kannst.

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

  • SPF-Check spf_check
  • DKIM-Check dkim_check
  • DMARC-Check dmarc_check
  • Spam-Wörter spam_words
  • Link-Reputation link_rep
  • Bild-Text-Verhältnis img_ratio
03

Screenshots und KI-Heatmaps im selben Test.

GET /spam-check/{id}/screenshots gibt CDN-URLs für die Desktop-, Tablet- und Mobil-Renderings deiner E-Mail zurück. Übernimm sie ohne weitere Verarbeitung in deine CI-Artefakte oder in dein Absender-Dashboard.

GET /spam-check/{id}/heatmap liefert KI-generierte Heatmaps zu Fokus und Aufmerksamkeit auf denselben drei Geräten. So siehst du genau, 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} gibt Score, Absender-Forensik, message-ID und das Array results[] zurück, sobald status auf "completed" springt. Frag mit Back-off ab oder häng es an einen Job-Worker.

  4. 04

    Screenshots, Vorschauen und Heatmaps holen (optional)

    /spam-check/{id}/screenshots für die drei Geräte-Renderings, /spam-check/{id}/client-previews für die E-Mail in über 50 echten Clients (siehe E-Mail-Vorschau-API) und /spam-check/{id}/heatmap für KI-Karten zu Fokus und Aufmerksamkeit. Alle nutzen dieselbe Test-id, in deinem Code fällt also keine zusätzliche Credit-Buchhaltung an.

Häufige Fragen zur API.

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

Wie bekomme ich API-Zugang?
API-Zugang gibt es in unserem White-Label-Plan, der komplett individuell ist: Die Limits für Spam-Tests, Inbox-Placement-Tests, Screenshots und Heatmaps werden auf dein Konto zugeschnitten. Sprich mit dem Vertrieb und nenne dein erwartetes Volumen, dann schneiden wir es passend zu.
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 mehr Burst-Kapazität oder eine eigene Leitung brauchst, öffne den Chat 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 === "completed" gilt. Die meisten Tests sind in wenigen Sekunden fertig, frag also mit exponentiellem Back-off ab oder nutze einen Job-Worker.
Kann ich mein verbleibendes Limit über die API abfragen?
GET /ext/v2/status gibt deine E-Mail-Adresse, den Namen deines Abos und die Limit-Map zurück (spam_check, inbox_placement, screenshots, heatmaps, has_history, has_ai_assistant). Praktisch, um die Nutzung in deiner eigenen Admin-UI anzuzeigen.
Wie genau ist der Spam-Score?
Der Score bildet ab, wie unsere Engines und Test-Postfächer die Nachricht bewerten. Die tatsächliche Zustellung hängt weiterhin von der Absender-Reputation, der Listenhygiene und dem Engagement der Empfänger ab. Die API liefert dir das Signal zu Inhalt und Authentifizierung, keine Garantie für 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 Self-Service-Testphase für die API bieten wir nicht an. Sprich mit dem Vertrieb, um Zugang zur Evaluierung zu bekommen. Die meisten Teams starten erst mit dem kostenlosen Web-Tool, um zu prüfen, ob die Testlogik zu ihrem Anwendungsfall passt.

Bereit, Unspam in deinen Stack zu integrieren?

API-Zugang ist im White-Label-Plan enthalten. Preise auf der öffentlichen Seite, individuelle Limits im Chat.

Preise ansehen