E-Mail-Vorschau-API.

Rendere per REST reines HTML, eine an uns gesendete E-Mail oder einen fertigen Test in über 60 echten Clients und Geräten und lies je einen Screenshot als JSON aus.

curl -X POST https://api.unspam.email/ext/v2/client-previews \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email_source": "raw-data",
    "subject": "Your order shipped",
    "body": "<!DOCTYPE html><html>...</html>",
    "devices": ["iphone18pro_27", "iphone18pro_27_dm"]
  }'

# frage die ID ab, bis status completed ist
{
  "id": "3f9a2c8e-1d4b-4c7a-9f2e-7b1e5da0c62f",
  "status": "pending"
}
curl -X POST https://api.unspam.email/ext/v2/client-previews \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email_source": "spam-check", "source_id": "2Bl8rzTFN6VV" }'

# die anderen beiden Quellen
"email_source": "inbox-placement"  # source_id
"email_source": "email"            # inbox_address
curl https://api.unspam.email/ext/v2/client-previews/3f9a2c8e-1d4b-4c7a-9f2e-7b1e5da0c62f \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# Antwort (200)
{
  "status": "completed",
  "previews": [
    {
      "device_key": "iphone18pro_27",
      "device_name": "iPhone 18 Pro (iOS 27)",
      "status": "completed",
      "original": "https://…/original.png",
      "thumbnail": "https://…/thumb.jpg",
      "download": "https://…/download"
    }
  ]
}
Endpoints
4
E-Mail-Quellen
4
Authentifizierung
Bearer-Token
Rate-Limit
100 pro Minute

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 als eigene Renderings.

Clients, die wir im Dunkelmodus erfassen, bekommen ein eigenes dunkles Rendering mit eigenem Geräteschlüssel. So fallen das invertierte Logo oder unlesbarer Text im Dunkelmodus in deiner Pipeline auf, nicht in Produktion.

Renderings mit dem Parameter devices eingrenzen.

Übergib devices mit Schlüsseln aus dem Katalog, um nur die Clients zu rendern, die dir wichtig sind (nur iOS Mail, nur alle Outlook-Versionen), oder lass es weg für alle Geräte deines Tarifs. Neu angefragte Geräte kommen als pending zurück; frag ab, bis jedes auf completed oder failed 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.

Echte Client-Screenshots als JSON: ein Eintrag pro Gerät, mit Bild in voller Größe, Thumbnail und Download-Link.

Vier Wege, die E-Mail zu übergeben.

Setz email_source auf spam-check oder inbox-placement und übergib die Test-ID als source_id, auf raw-data mit eigenem subject und body als HTML oder auf email, um einen Entwurf mit inbox_address zu erhalten und die Nachricht dorthin zu schicken.

Der body einer raw-data-Vorschau muss das vollständige HTML einer gestalteten E-Mail sein, mit mindestens 1.000 Zeichen und 10 HTML-Elementen, sonst wird er mit 422 abgelehnt. Eine Nachricht an einen Entwurf ohne oder mit zu wenig HTML wird weder gerendert noch berechnet: Der Entwurf behält seine Adresse und setzt rejection_reason.

  • spam-check source_id
  • inbox-placement source_id
  • raw-data subject, body
  • email inbox_address

Pixelgenaue Renderings, Gerät für Gerät.

GET /client-previews/{id} liefert einen übergeordneten status und ein Array previews[] mit einem Eintrag pro Gerät: device_key, device_name, seine Kategorie, den status des Geräts und URLs für original, thumbnail und download.

Die Bild-URLs bleiben null, bis das Gerät auf completed steht. Eine einfache Polling-Schleife holt so den ganzen Satz ab. Ein Gerät kann auch als failed enden, brich also auch dann ab. GET /client-previews listet deine raw-data- und email-Vorschauen; Vorschauen aus Tests erreichst du über die client_preview_id des Tests.

gmail · hell
outlook · dunkel
iphone

Ein Gerätekatalog, gegen den du filtern kannst.

GET /client-preview-devices listet jeden renderbaren Client mit device_key, Anzeigename und Client-Familie als Kategorie auf, etwa Gmail, iPhone / iPad oder Outlook desktop (Windows). 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 und ums Limit: Jedes Gerät in einer Anfrage verbraucht eine Geräte-Vorschau. So kann ein CI-Job, der bei jeder Template-Änderung läuft, genau die drei Outlook-Versionen rendern, auf die es ankommt, dafür drei Vorschauen verbrauchen und nur diese prüfen.

  • Gmail.com (Chrome, Windows 10) Gmail
  • iPhone 18 Pro (iOS 27) iPhone / iPad
  • Apple Mail 16 (macOS 13) Apple Mail (macOS)
  • Yahoo (Chrome) Yahoo
  • AOL (Chrome) AOL

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 asynchron: Wähl die Quelle der E-Mail, leg die Vorschau an und lies dann die Renderings pro Gerät aus.

  1. 01

    Wähl die Quelle der E-Mail

    Ein fertiger Spam- oder Placement-Test, dein eigener Betreff und dein HTML oder eine Nachricht an eine Entwurfsadresse.

  2. 02

    Leg die Vorschau an

    POST /ext/v2/client-previews mit email_source und dem, was diese Quelle braucht. Die 201-Antwort enthält die Vorschau-id, bei der Quelle email zusätzlich die inbox_address, an die du sendest.

  3. 03

    Lies die Renderings aus

    Frag GET /ext/v2/client-previews/{id} mit Back-off ab. Jedes Gerät wechselt von pending zu completed oder failed, und seine Bild-URLs erscheinen, sobald es fertig ist.

  4. 04

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

    Hol den Katalog über GET /ext/v2/client-preview-devices und übergib devices im POST-Body, um nur eine Auswahl zu rendern. Unbekannte Schlüssel werden ignoriert, und der Aufruf antwortet nur dann mit 422, wenn keiner verfügbar ist.

Die Endpoints dahinter.

4 Endpoints, mit demselben Token wie die restliche API. Im OpenAPI-Dokument stehen alle Parameter und Response-Codes.

OpenAPI-Dokument
Client Previews 4 Aufrufe
  • GET /client-preview-devices
  • GET /client-previews
  • POST /client-previews
  • GET /client-previews/{id}

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?
Wähl eine Quelle und ruf POST /ext/v2/client-previews auf: raw-data mit subject und body für HTML, das du noch nicht versendet hast, email für eine Entwurfsadresse, an die du eine Nachricht schickst, oder spam-check bzw. inbox-placement mit der Test-ID als source_id. Dann liefert GET /ext/v2/client-previews/{id} pro Gerät einen Eintrag mit eigenem status und Bild-URLs. Geräte werden unabhängig voneinander fertig, frag also ab, bis der benötigte Satz durch ist.
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. Jedes Gerät in der Anfrage verbraucht eine Geräte-Vorschau aus deinem Limit. Das Eingrenzen ändert also, was zurückkommt, und auch, was es kostet. Im individuellen Plan enthält der Katalog außerdem Renderings der neuesten Geräte: iPhone 18 Pro, die Gmail-App auf Pixel 10 und iPhone 16, die Outlook Microsoft 365 App unter Windows 11 und macOS, New Outlook for Windows und Gmail im Web unter Chrome.
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, mit einem eigenen dunklen Rendering für Clients, die wir im Dunkelmodus erfassen. 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 die API, hol die Renderings deiner wichtigsten Clients und häng sie als Build-Artefakte an oder vergleiche sie mit dem vorigen Lauf. Nimm einen Spam-Test als Quelle, dann liefert derselbe Lauf auch den Spam-Score, und ein Job deckt Rendering und Zustellbarkeit gemeinsam 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 (Desktop, Tablet, Mobilgerät) der Nachricht. POST /client-previews rendert die E-Mail in über 60 echten Client-Anwendungen, mit dunklen Renderings für Clients, die wir im Dunkelmodus erfassen. So fallen client-spezifische Fehler auf, etwa durch die Word-Engine von Outlook oder ein invertiertes Logo im Dunkelmodus.
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.