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", ... },
    { "id": "dkim", ... },
    { "id": "dmarc", ... }
  ],
  "report_url": "https://unspam.email/results/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

POST /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 zwei Sub-Ressourcen: /screenshots liefert Renderings für Desktop, Tablet und Mobil, und /heatmap gibt KI-generierte Karten zu Fokus und Aufmerksamkeit für dieselbe E-Mail zurück. Übergib dieselbe Test-ID an POST /client-previews, um die E-Mail in über 50 echten Clients und auf echten Geräten zu rendern.

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 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
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
  • DKIM-Check dkim
  • DMARC-Check dmarc
  • 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 Bild-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}/heatmap für KI-Karten zu Fokus und Aufmerksamkeit und POST /client-previews mit derselben Test-ID für die E-Mail in über 50 echten Clients (siehe E-Mail-Vorschau-API). Jedes davon zählt gegen ein eigenes Limit: Screenshots und Heatmap verbrauchen beim ersten Abruf eine Einheit, und jede Vorschau-Anfrage verbraucht eine Geräte-Vorschau, egal wie viele Geräte sie umfasst. Rufst du die Heatmap vor den Screenshots ab, verbrauchst du dabei auch eine Screenshot-Einheit, weil die Heatmap auf dem Desktop-Screenshot berechnet wird.

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 === "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 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.

Preise ansehen