Unspam API.

Führe dieselben Prüfungen wie im Dashboard aus deinem eigenen Code aus: Spam-Tests, Inbox-Placement, Client-Vorschauen, DMARC-Berichte und wiederkehrende automatische Tests. 39 Endpoints in 7 Bereichen, ein Bearer-Token, JSON rein und JSON raus.

POST /ext/v2/spam-check OpenAPI-Dokument

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": 84,
  "results": [
    { "id": "spf", ... },
    { "id": "dkim", ... },
    { "id": "dmarc", ... }
  ]
}

Was die API abdeckt.

39 Endpoints in 7 Gruppen, so geordnet, wie die API selbst sie gruppiert. Die vollständige Referenz mit jedem Parameter und jedem Statuscode ist das OpenAPI-Dokument.

Client Previews

4 Aufrufe

GET /client-preview-devices
GET /client-previews
POST /client-previews
GET /client-previews/{id}

DMARC Reports

10 Aufrufe

GET /dmarc/domains
POST /dmarc/domains
GET /dmarc/domains/{id}
GET /dmarc/domains/{id}/dns-instructions
GET /dmarc/domains/{id}/ips
GET /dmarc/domains/{id}/ips/{ip}
GET /dmarc/domains/{id}/reports
POST /dmarc/domains/{id}/verify
GET /dmarc/reports/{id}
GET /dmarc/reports/{id}/records

Inbox Placement

4 Aufrufe

GET /inbox-placement
POST /inbox-placement
GET /inbox-placement/mailboxes
GET /inbox-placement/{id}

Automatic Testing: Senders

6 Aufrufe

GET /scheduled-test-senders
POST /scheduled-test-senders
GET /scheduled-test-senders/{id}
PUT /scheduled-test-senders/{id}
DELETE /scheduled-test-senders/{id}
POST /scheduled-test-senders/{id}/test-connection

Automatic Testing: Tests

9 Aufrufe

GET /scheduled-tests
POST /scheduled-tests
GET /scheduled-tests/{id}
PUT /scheduled-tests/{id}
PATCH /scheduled-tests/{id}
DELETE /scheduled-tests/{id}
POST /scheduled-tests/{id}/dispatch-now
GET /scheduled-tests/{id}/runs
GET /scheduled-tests/{id}/runs/{runId}

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

Was du damit bauen kannst.

Testen, bevor du auslieferst

Starte einen Spam-Test aus einem Deploy-Schritt oder einem CI-Job, sende die Nachricht, die deine Anwendung wirklich sendet, und lies den Score, bevor die Kampagne rausgeht.

Wiederkehrende Inbox-Tests

Verbinde einmal einen Absender und lass geplante Tests in ihrer eigenen Taktung laufen, damit das Inbox-Placement nach Plan geprüft wird und nicht erst, wenn jemand daran denkt.

Vorschauen in echten Clients

Fordere Client-Vorschauen zu einem bereits gelaufenen Test an und erhalte einen Eintrag pro Gerät, jeder in einem echten Client aufgenommen und nicht aus dem Markup simuliert.

Ergebnisse als JSON

Scores, Authentifizierungsergebnisse, Heatmaps und Screenshots kommen als JSON zurück und landen so in deinem eigenen Dashboard oder deinen eigenen Alerts.

DMARC-Berichte für deine Domain

Registriere eine Domain, veröffentliche den TXT-Eintrag, den die API zurückgibt, und lies die Aggregate-Berichte als JSON: wer im Namen deiner Domain sendet und ob diese Nachrichten DMARC bestehen.

Steuerung über einen KI-Assistenten

Dieselben Aufgaben stehen über MCP für Claude, ChatGPT, Cursor und andere MCP-Clients bereit, sodass ein Assistent einen Test starten und das Ergebnis lesen kann, ohne dass Client-Code geschrieben wird.

Wo die API hinpasst.

Alles, was bereits HTTP spricht, kann diese Prüfungen ausführen. Das sind die Stellen, an denen die API üblicherweise landet, und die Teams, die am meisten davon haben.

Apps und Pipelines, in die sie sich einfügt.

CI- und Deploy-Pipelines

Führe einen Spam-Test als Build-Schritt aus und lass den Deploy fehlschlagen, wenn der Score fällt, damit eine Template-Änderung dich nicht unbemerkt den Posteingang kostet.

Dein Versand-Stack

Der Test empfängt eine echte Nachricht über deinen echten Versandweg: SES, Postmark, SendGrid, Mailgun oder deinen eigenen SMTP-Server, was auch immer deine E-Mails heute schon versendet.

Interne Dashboards

Scores, Placement und Authentifizierungsergebnisse kommen als JSON zurück und landen so in dem Dashboard, das dein Team ohnehin im Blick hat.

Alerting und Rufbereitschaft

Frag geplante Testläufe aus einem Cron-Job ab und alarmiere die Rufbereitschaft, wenn das Placement fällt, bevor die Öffnungsrate nachzieht.

Produkte, die E-Mails versenden

Bau mit dem individuellen Plan jeden Test in dein eigenes Produkt ein: Ein E-Mail-Builder oder eine Agenturplattform kann Spam-Tests, Inbox-Placement und Vorschauen unter eigener Marke weiterverkaufen.

KI-Assistenten

Über MCP sind dieselben Aufgaben Tools, die ein Assistent aufrufen kann, sodass eine Prüfung mitten in einer Unterhaltung läuft, ohne dass eine Zeile Client-Code geschrieben wird.

Wer am meisten davon hat.

Agenturen Steuere die Zustellbarkeit aller Kunden aus einem Konto und berichte unter deiner eigenen Marke. SaaS Passwort-Resets, Magic Links und Rechnungs-E-Mails sind Teil des Produkts: Eine E-Mail, die niemand sieht, ist ein Incident. E-Commerce Der Kampagnenumsatz folgt dem Inbox-Placement, deshalb werden die Aussendungen im Kampagnenkalender getestet, bevor sie rausgehen. Newsletter Wenn der Posteingang das Produkt ist, ist das Placement die Zahl, an der das Geld hängt, also wird es nach Zeitplan geprüft. Entwickler Ein Bearer-Token, IDs zum Abfragen und Ergebnisse als JSON: Die Integration ist ein Nachmittag, kein Sprint. Enterprise Ein Token pro Integration, jedes einzeln widerrufbar, sodass ein Security-Review den Zugriff eines Systems kappen kann, ohne die übrigen anzufassen.

Bau Unspam in dein eigenes Produkt ein.

Mit dem individuellen Plan baust du jeden Unspam-Test in deine eigene Software ein und verkaufst ihn unter deiner eigenen Marke an deine Kunden weiter. Du buchst ihn online, und das Volumen wächst mit dir.

Deine Oberfläche, deine Marke.

Die Ergebnisse kommen als JSON, also sehen deine Kunden dein Produkt, deinen Namen und dein Design. Weiterverkaufen ist im individuellen Plan erlaubt.

Jeder Test, eine Integration.

Spam-Tests, Inbox-Placement, Client-Vorschauen, Heatmaps und DMARC-Berichte laufen über dieselbe API und denselben MCP-Server.

Online gebucht, nach deinem Bedarf.

Wähle dein monatliches Volumen auf der Preisseite, ab einem Mindestbetrag von $5. Die Preise sinken, wenn du wächst, bei jährlicher Abrechnung sparst du 15 %, und für jeden kostenpflichtigen Plan gilt eine 14-tägige Geld-zurück-Garantie.

Fragen gehen an den Support.

Höhere Rate-Limits, Rechnungsstellung oder eine Frage zur Integration: Eröffne ein Support-Ticket, und wir antworten dort.

Stell dir deinen Plan zusammen

Wie der Zugang funktioniert.

Ein Token pro Integration, ein kleiner Satz Statuscodes und dieselben Aufgaben für KI-Clients über MCP.

Tokens, die du einzeln widerrufst

Jede Anfrage trägt ein Bearer-Token im Authorization-Header. Tokens werden in deinem Konto erstellt, eines pro Integration, und der Widerruf eines Tokens lässt die anderen weiterlaufen.

Ein fehlendes, fehlerhaftes oder widerrufenes Token antwortet mit 401. Ein gültiges Token auf einem Konto, das diesen Aufruf nicht machen darf, antwortet mit 403, und der Body benennt den Grund. So wird ein Abrechnungsproblem nie mit einer kaputten Integration verwechselt.

IDs, die du abfragst, keine Webhooks, die du hostest

Ein Aufruf, der Arbeit startet, antwortet mit einer ID. Du fragst diese ID ab, bis das Ergebnis bereit ist. Damit bleibt die Integration bei ausgehendem HTTP und nichts von dir liegt öffentlich offen.

Die API verwendet einen kleinen Satz Codes und nichts darüber hinaus. Ein 422 heißt, die Anfrage wurde gelesen und die Werte abgelehnt, mit benannten Feldern. So sieht ein falscher Payload nie wie ein abgelehntes Konto aus.

Dieselben Aufgaben über MCP

KI-Clients erreichen dieselbe Arbeit über MCP, als JSON-RPC 2.0 an einen einzigen Endpoint. So kann ein Assistent einen Spam-Test starten und das Ergebnis lesen, ohne dass jemand einen Client dafür schreibt.

MCP authentifiziert mit OAuth 2.1 und es gibt kein Token zum Einfügen: der Client führt den Flow aus, wenn du den Server hinzufügst. Das Bearer-Token oben gilt nur für die REST-API.

Vom Token zum Ergebnis in vier Schritten.

Der Spam-Test ist der kürzeste Weg durch die API. Inbox-Placement und Vorschauen folgen derselben Form: etwas starten, die ID nehmen, das Ergebnis lesen.

01
Token erstellen

In deinem Konto, ein Token pro Integration, jedes einzeln widerrufbar.
02
Test starten

Ein POST auf den Spam-Test-Endpoint. Die Antwort enthält die Test-ID und die Adresse, an die du deine E-Mail sendest.
03
E-Mail senden

Von der Plattform, mit der du wirklich sendest, an die Adresse, die die API zurückgegeben hat, damit der Test dein echtes Sende-Setup misst und keine Kopie davon.
04
Ergebnis lesen

Ein GET auf den Test per ID liefert Score und Authentifizierungsergebnisse, danach forderst du Heatmap oder Client-Vorschauen zur selben ID an.

Häufige Fragen zur API.

Pläne, Limits, wo die Referenz liegt und was dir ein 403 sagt.

Welcher Plan enthält 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.

Gibt es eine Referenz mit allen Parametern?

Ja. Das OpenAPI-Dokument ist die Referenz und wird aus der API selbst erzeugt, kann also keinen Aufruf beschreiben, den der Dienst nicht beantwortet. Es ist im Codebeispiel oben verlinkt.

Wie sind die Rate-Limits?

Alle Endpoints sind auf 100 Anfragen pro Minute begrenzt: pro IP-Adresse bei öffentlichen Endpoints, pro Konto bei authentifizierten Anfragen. Über dem Limit antwortet die API mit 429 Too Many Requests, warte also und versuch es erneut, statt ein größeres Budget anzunehmen. Der MCP-Server begrenzt Anfragen pro Konto auf dieselbe Weise. Wenn du ein höheres Limit brauchst, eröffne ein Support-Ticket und nenne deinen erwarteten Durchsatz.

Was bedeutet ein 403?

Das Token ist gültig und das Konto darf diesen Aufruf nicht machen. Der Body trägt einen Grund: die Konto-E-Mail ist noch nicht bestätigt, das Kontingent deines Plans für diesen Aufruf ist in der Periode aufgebraucht, oder der Plan enthält keinen API-Zugang.

Kann ein KI-Assistent sie nutzen?

Ja, über MCP statt REST. Der MCP-Server stellt dieselben Aufgaben als Tools bereit, die ein Assistent aufrufen kann, mit OAuth 2.1 anstelle eines Bearer-Tokens.

Braucht sie Zugang zu meiner E-Mail-Plattform?

Nicht für einen Spam-Test oder eine Vorschau. Du sendest eine Nachricht an eine Adresse, die dir die API gibt, von dem aus, womit du schon sendest, und die API liest, was angekommen ist. Wiederkehrende automatische Tests sind anders, weil etwas sie planmäßig senden muss, also wird dafür ein Absender über SMTP verbunden.

Kann ich DMARC-Berichte über die API sammeln?

Ja. Registriere deine Domain, veröffentliche den TXT-Eintrag aus der Antwort (er wird mit einem vorhandenen DMARC-Eintrag zusammengeführt, statt ihn zu ersetzen) und verifiziere ihn mit einer Live-DNS-Prüfung. Aggregate-Berichte treffen meist innerhalb von 24 bis 48 Stunden ein; danach listest du sie pro Domain auf und liest jeden Bericht bis hinunter zu den Zeilen pro Absenderquelle. Aufgenommen werden nur Berichte geprüfter Reporting-Organisationen.

Bereit, Zustellbarkeit in deinen eigenen Stack zu holen?

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