E-Mail-Vorschau-API.

Rendere deine echte E-Mail in über 50 echten E-Mail-Clients und auf echten Geräten, per REST: Spam-Test anlegen, Nachricht senden, Vorschauen für diesen Test anfordern, dann pixelgenaue Renderings als JSON auslesen, jedes aus einem echten Client im hellen und im dunklen Modus aufgenommen. Dieselben Renderings gibt es als MCP-Tools, damit KI-Agenten einen Rendering-Test in normaler Sprache starten können.

POST /ext/v2/client-previews
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"
}

# send your email to inbox_address,
# then read the previews per device.
curl -X POST https://api.unspam.email/ext/v2/client-previews \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -d '{"email_source":"spam-check","source_id":"2Bl8rzTFN6VV"}'

# then poll the preview by its own id
curl https://api.unspam.email/ext/v2/client-previews/3f9a2c8e \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "status": "completed",
  "previews": [
    {
      "device_key": "aol_chrome",
      "device_name": "AOL (Chrome)",
      "status": "completed",
      "original": "https://…/original.png",
      "thumbnail": "https://…/thumb.jpg"
    }
    // one entry per device, 50+ in total
  ]
}

Die Vorschau-Aufrufe und die ganze Suite, mit einem Key.

Die E-Mail-Vorschau-API teilt sich Token, Rate Limits und Abrechnung mit der Spam-Check- und der Inbox-Placement-API. Rendering hängt sich also an die Integration, die du ohnehin schon betreibst.

Client-Vorschauen

POST /client-previewsRendering deiner E-Mail in über 50 echten Clients und auf echten Geräten, hell und dunkel, als Bild-URLs, die du über die Vorschau-ID abrufst.

Gerätekatalog

GET /client-preview-devicesJeder renderbare Client mit Key und Kategorie, als Basis für den devices-Filter.

Spam-Tests

POST /spam-checkDer Test, der die Vorschauen trägt: Score, Absender-Forensik und die Aufschlüsselung pro Check im selben Ergebnis.

MCP-Tools

create_client_previewDie Vorschau-Endpoints als MCP-Tools für Claude, Cursor, ChatGPT und jeden Remote-MCP-Client.

Warum Teams Vorschauen in ihre Pipeline einbauen.

Aufnahmen aus echten Clients, keine Simulationen.

Jede Vorschau ist deine E-Mail, geöffnet in einer echten Installation des Clients auf dem echten Gerät und dann als Screenshot aufgenommen. Keine CSS-Transformationen, keine Browser-Emulation: Das Bild, das du bekommst, ist genau das, was ein Abonnent in diesem Client sieht.

Hell und dunkel in jedem Client.

Jeder der über 50 Clients rendert in beiden Modi. Ein Aufruf liefert also über 100 Bilder, und das invertierte Logo oder der unlesbare Text im Dark Mode fällt in deiner Pipeline auf, nicht in der Produktion.

Renderings mit dem Parameter <code>devices</code> eingrenzen.

Übergib devices mit Keys aus dem Katalog, um nur die Clients zu rendern, die dich interessieren (nur iOS Mail, nur die Outlook-Versionen), oder lass den Parameter weg für den kompletten Satz. Neu angeforderte Geräte kommen als pending zurück; frag sie ab, bis jedes auf completed steht.

MCP-Tools für KI-Agenten.

Die Vorschau-Endpoints gibt es als MCP-Tools (create_client_preview, list_client_preview_devices) auf dem Unspam MCP-Server. Claude, Cursor oder jeder andere MCP-Client holt sich damit echte Client-Renderings mitten im Gespräch.

Was die Vorschau-Endpoints zurückgeben.

Screenshots aus echten Clients als JSON: ein Eintrag pro Gerät, jeder aus einem echten Client im hellen und im dunklen Modus aufgenommen.

01

Pixelgenaue Vorschauen für jeden Test.

POST /client-previews mit email_source auf spam-check und der Test-ID als source_id startet die Renderings. Danach gibt GET /client-previews/{id} einen status auf oberster Ebene zurück sowie ein Array previews[] mit einem Eintrag pro Gerät: device_key, device_name, einen eigenen status pro Gerät und URLs für das original- und das thumbnail-Rendering.

original und thumbnail bleiben null, bis das jeweilige Gerät auf completed springt. Eine einfache Polling-Schleife holt so den ganzen Satz ab. Die meisten Geräte sind nach etwa einer Minute da.

gmail · hell
outlook · dunkel
iphone
02

Ein Gerätekatalog, gegen den du filtern kannst.

GET /client-preview-devices listet jeden renderbaren Client mit device_key, Anzeigename und Kategorie auf (DESKTOP, MOBILE, WEB). Leg ihn im Cache ab, zeig ihn in deiner eigenen UI oder bau daraus den devices-Filter für den Render-Aufruf.

Beim Filtern geht es um das Signal, nicht ums Limit: Eine Vorschau-Anfrage verbraucht eine Geräte-Vorschau, egal wie viele Geräte sie umfasst. So kann ein CI-Job, der bei jeder Template-Änderung läuft, genau die drei Outlook-Versionen rendern, auf die es ankommt, und nur diese prüfen.

  • AOL (Chrome) category: WEB
  • Outlook 2019 category: DESKTOP
  • Apple Mail category: DESKTOP
  • iOS Mail category: MOBILE
  • Android category: MOBILE
03

Dieselben Vorschauen, per MCP von KI-Agenten aufrufbar.

Verbinde den Unspam MCP-Server per OAuth, und dein Assistent bekommt die Vorschau-Tools direkt neben Spam-Tests und Inbox Placement. Bitte ihn, die Kampagne zu rendern und alles zu melden, was im Dark Mode von Outlook kaputt ist: Die Aufrufe verkettet er selbst.

Mit MCP prüfen deine Agenten-Workflows Renderings aus echten Clients, ohne dass jemand ein Dashboard öffnet.

  • Rendere diese Kampagne create_client_preview
  • Welche Clients kannst du rendern? list_client_preview_devices
  • Führe den kompletten Check aus start_spam_check

So funktioniert die E-Mail-Vorschau-API in vier Schritten.

Vorschauen laufen über den Spam-Test: Test anlegen, deine E-Mail an die Adresse schicken, die wir zurückgeben, Vorschauen für diesen Test anfordern, dann die Renderings pro Gerät auslesen.

  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. Gerendert wird genau die Nachricht, die auch deine Empfänger bekommen würden.

  3. 03

    Client-Vorschauen anfordern

    POST /ext/v2/client-previews mit email_source auf spam-check und der Test-ID als source_id, dann frag GET /ext/v2/client-previews/{id} mit Back-off ab, solange Geräte auf pending stehen; die URLs erscheinen, sobald ein Gerät fertig ist.

  4. 04

    Geräte filtern, wenn du es brauchst (optional)

    Hol dir den Katalog über GET /ext/v2/client-preview-devices und übergib devices im POST-Body, um nur eine Teilmenge zu rendern. Derselbe Test liefert auch /screenshots und /heatmap, wenn du die visuellen Extras willst.

Häufige Fragen zur API.

Integration, Gerätefilter, MCP-Zugang für KI-Agenten und wie sich die Vorschau-Endpoints verhalten.

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 läuft die E-Mail-Vorschau ab?
Vorschauen werden für einen Spam-Test angefordert. POST /ext/v2/spam-check gibt eine inbox_address zurück, du schickst die echte E-Mail dorthin, dann startet POST /ext/v2/client-previews mit email_source auf spam-check und der Test-ID als source_id die Renderings, und GET /ext/v2/client-previews/{id} liefert einen Eintrag pro Gerät mit eigenem status und Bild-URLs. Geräte werden unabhängig voneinander fertig, frag also ab, bis der Satz, den du brauchst, auf completed steht. Für HTML, das du nicht verschickt hast, setzt du email_source auf raw-data und übergibst subject und body.
Kann ich nur bestimmte Clients rendern?
Ja. Übergib devices im Body von POST /ext/v2/client-previews mit Keys aus GET /ext/v2/client-preview-devices, um nur eine Teilmenge zu rendern, zum Beispiel nur iOS Mail oder nur die Outlook-Familie. Eine Vorschau-Anfrage verbraucht eine Geräte-Vorschau aus deinem Limit, egal wie viele Geräte sie umfasst. Das Eingrenzen ändert also, was zurückkommt, nicht, was es kostet.
Sind die Vorschauen echte Clients oder Simulationen?
Echte Clients. Jedes Rendering ist deine E-Mail, geöffnet in einer echten Installation des Clients auf dem echten Gerät und als Screenshot aufgenommen, im hellen wie im dunklen Modus. Genau das unterscheidet eine E-Mail-Rendering-API auf Basis echter Clients von den CSS-Simulationen, die die meisten kostenlosen Vorschau-Tools liefern.
Kann ich damit Rendering-QA in der CI machen?
Das ist der Hauptanwendungsfall. Schick eine Template-Änderung in einem CI-Schritt durch den Ablauf, hol dir die Renderings deiner kritischen Clients und häng sie als Build-Artefakte an oder vergleiche sie mit dem vorherigen Lauf. Derselbe Test liefert den Spam-Score, ein Job deckt also Rendering und Zustellbarkeit zusammen ab.
Können KI-Agenten E-Mail-Vorschauen erzeugen?
Ja. Die Vorschau-Endpoints stehen als Tools auf dem Unspam MCP-Server bereit: create_client_preview, list_client_previews und list_client_preview_devices, direkt neben den Tools für Spam-Test und Inbox Placement. Verbinde Claude, Cursor oder ChatGPT per OAuth und frag in normaler Sprache nach Renderings, ganz ohne Keys zum Einfügen.
Was ist der Unterschied zum Screenshots-Endpoint?
/spam-check/{id}/screenshots liefert drei Viewport-Renderings der Nachricht (Desktop, Tablet, Mobil). POST /client-previews rendert die E-Mail in über 50 echten Client-Anwendungen, jeweils im hellen und im dunklen Modus, und fängt so Client-spezifische Fehler ab, etwa die Word-Engine von Outlook oder ein im Dark Mode invertiertes Logo.
Wie sehen die Rate Limits aus?
Das öffentliche Limit liegt bei 100 Requests pro Minute pro IP oder pro authentifiziertem Konto. Polling für Vorschauen passt mit normalem Back-off bequem hinein. Wenn du ein höheres Limit brauchst, eröffne ein Support-Ticket und nenne deinen erwarteten Durchsatz.
Kann ich das in mein eigenes Produkt einbauen und weiterverkaufen?
Ja, mit dem individuellen Plan. Jede Vorschau kommt als JSON mit einer Bild-URL pro Client und Gerät zurück, sodass du die Renderings in deiner eigenen Oberfläche zeigen und unter deiner eigenen Marke an deine Kunden weiterverkaufen kannst.

Bereit, E-Mails aus deinem eigenen Stack zu rendern?

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