Unspam API.

Führen Sie dieselben Prüfungen wie im Dashboard aus Ihrem eigenen Code aus: Spam-Tests, Inbox-Placement, Client-Vorschauen und wiederkehrende automatische Tests. 29 Endpoints in 6 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"
}

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

# Antwort (200)
{
  "score": 8.4,
  "spf": "pass",
  "dkim": "pass",
  "dmarc": "pass"
}

Was die API abdeckt.

29 Endpoints in 6 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}

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 Sie damit bauen können.

Testen, bevor Sie ausliefern

Starten Sie einen Spam-Test aus einem Deploy-Schritt oder einem CI-Job, senden Sie die Nachricht, die Ihre Anwendung wirklich sendet, und lesen Sie den Score, bevor die Kampagne rausgeht.

Wiederkehrende Inbox-Tests

Verbinden Sie einmal einen Absender und lassen Sie 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

Fordern Sie Client-Vorschauen zu einem bereits gelaufenen Test an und erhalten Sie 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 Ihrem eigenen Dashboard oder Ihren eigenen Alerts.

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ühren Sie einen Spam-Test als Build-Schritt aus und lassen Sie den Deploy fehlschlagen, wenn der Score fällt, damit eine Template-Änderung Sie nicht unbemerkt den Posteingang kostet.

Ihr Versand-Stack

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

Interne Dashboards

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

Alerting und Rufbereitschaft

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

Produkte, die E-Mails versenden

Betten Sie die Prüfungen mit dem White-Label-Plan in Ihr eigenes Produkt ein: Ein E-Mail-Builder oder eine Agenturplattform kann Spam-Tests unter eigener Marke anbieten.

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 Steuern Sie die Zustellbarkeit aller Kunden aus einem Konto und berichten Sie unter Ihrer 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.

Wie der Zugang funktioniert.

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

Tokens, die Sie einzeln widerrufen

Jede Anfrage trägt ein Bearer-Token im Authorization-Header. Tokens werden in Ihrem 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 Sie abfragen, keine Webhooks, die Sie hosten

Ein Aufruf, der Arbeit startet, antwortet mit einer ID. Sie fragen diese ID ab, bis das Ergebnis bereit ist. Damit bleibt die Integration bei ausgehendem HTTP und nichts von Ihnen 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 Sie den Server hinzufügen. 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 Ihrem 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 Sie Ihre E-Mail senden.
03
E-Mail senden

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

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

Häufige Fragen zur API.

Tarife, Limits, wo die Referenz liegt und was ein 403 Ihnen sagt.

Welcher Tarif enthält API-Zugang?

API-Zugang ist im White-Label-Tarif enthalten. Die aktuellen Preise stehen auf der Preisseite.

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?

Die REST-API veröffentlicht kein Rate-Limit und kein Endpoint dokumentiert eine 429-Antwort. Lesen Sie das als nicht spezifiziert und nicht als unbegrenzt: warten Sie nach wiederholten Fehlern, statt ein Budget anzunehmen. Der MCP-Server begrenzt Anfragen pro Konto und antwortet mit 429, sobald Sie das Limit überschreiten.

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 Tarifkontingent für diesen Aufruf ist in der Periode aufgebraucht, oder der Tarif 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. Sie senden eine Nachricht an eine Adresse, die die API Ihnen gibt, von dem aus, womit Sie schon senden, 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.

Bereit, Zustellbarkeit in Ihren eigenen Stack zu holen?