API de prévisualisation des e-mails.

Obtenez le rendu de votre e-mail réel dans plus de 50 clients de messagerie et appareils réels via REST : créez un test de spam, envoyez le message, puis récupérez en JSON des prévisualisations au pixel près, chacune capturée depuis un client réel en mode clair et en mode sombre. Les mêmes rendus sont exposés comme outils MCP, pour que les agents IA puissent lancer un test de rendu d’e-mail en langage naturel.

GET /ext/v2/spam-check/{id}/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 https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV/client-previews \
  -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.png"
    }
    // one entry per device, 50+ in total
  ]
}

Deux endpoints de prévisualisation. Toute la suite avec une seule clé.

L’API de prévisualisation partage son token, ses limites de requêtes et sa facturation avec les API de test de spam et de placement en boîte de réception : le rendu se branche donc sur l’intégration que vous exploitez déjà.

Prévisualisations dans les clients de messagerie

GET /spam-check/{id}/client-previewsVotre e-mail rendu dans plus de 50 clients de messagerie et appareils réels, en mode clair et sombre, sous forme de PNG hébergés sur CDN.

Catalogue d’appareils

GET /client-preview-devicesTous les clients dont le rendu est possible, avec leur clé et leur catégorie, pour construire le filtre devices.

Tests de spam

POST /spam-checkLe test qui porte les prévisualisations : score, analyse de l’expéditeur et détail de chaque vérification dans le même résultat.

Outils MCP

get_spam_check_client_previewsLes endpoints de prévisualisation comme outils MCP pour Claude, Cursor, ChatGPT et tout client MCP distant.

Pourquoi les équipes intègrent les prévisualisations à leur pipeline.

Des captures de clients réels, pas des simulations.

Chaque prévisualisation est votre e-mail ouvert dans une copie réelle du client et de l’appareil, puis capturé en image. Aucune transformation CSS, aucune émulation de navigateur : le PNG que vous recevez est exactement ce que voit un abonné sur ce client.

Mode clair et mode sombre sur chaque client.

Chacun des plus de 50 clients effectue son rendu dans les deux modes : un seul appel renvoie donc plus de 100 images, et le logo inversé ou le texte illisible en mode sombre apparaît dans votre pipeline, pas en production.

Ciblez les rendus avec le paramètre <code>devices</code>.

Passez devices avec des clés du catalogue pour ne générer que les clients qui vous intéressent (uniquement iOS Mail, uniquement les versions d’Outlook), ou omettez-le pour l’ensemble complet. Les appareils nouvellement demandés reviennent en pending ; interrogez l’API jusqu’à ce que chacun soit completed.

Des outils MCP pour les agents IA.

Les endpoints de prévisualisation sont livrés comme outils MCP (get_spam_check_client_previews, list_client_preview_devices) sur le serveur MCP d’Unspam : Claude, Cursor ou n’importe quel client MCP peut donc récupérer de vrais rendus de clients en pleine conversation.

Ce que renvoient les endpoints de prévisualisation.

Des captures de clients réels en JSON : une entrée par appareil, chacune capturée depuis un client réel en mode clair et en mode sombre.

01

Des prévisualisations au pixel près, en sous-ressource du test de spam.

GET /spam-check/{id}/client-previews renvoie un status de premier niveau et un tableau previews[] avec une entrée par appareil : device_key, device_name, un status par appareil et les URL du CDN pour les rendus original et thumbnail.

original et thumbnail restent à null jusqu’à ce que l’appareil passe à completed : une simple boucle d’interrogation vide donc tout l’ensemble. La plupart des appareils arrivent en une minute environ.

gmail · clair
outlook · sombre
iphone
02

Un catalogue d’appareils sur lequel filtrer.

GET /client-preview-devices liste chaque client dont le rendu est possible avec son device_key, son nom affiché et sa catégorie (DESKTOP, MOBILE, WEB). Mettez-le en cache, affichez-le dans votre propre interface ou servez-vous-en pour construire le filtre devices de l’appel de rendu.

Le filtrage compte pour votre limite : générer trois versions d’Outlook au lieu de l’ensemble complet dépense vos prévisualisations d’appareils à bon escient, ce qui est exactement ce que vous voulez dans un job CI déclenché à chaque modification de modèle.

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

Les mêmes prévisualisations, appelables par des agents IA via MCP.

Connectez le serveur MCP d’Unspam par OAuth et votre assistant obtient les outils de prévisualisation aux côtés des tests de spam et du placement en boîte de réception. Demandez-lui de générer le rendu de la campagne et de signaler tout ce qui casse en mode sombre sur Outlook : il enchaîne les appels tout seul.

Aucun autre service de prévisualisation d’e-mails ne donne aujourd’hui aux agents IA accès à des rendus de clients réels : la prise en charge de MCP permet à vos workflows d’agents de faire la QA du rendu sans que personne n’ouvre un tableau de bord.

  • Générez le rendu de cette campagne get_spam_check_client_previews
  • Quels clients pouvez-vous prévisualiser ? list_client_preview_devices
  • Lancez le test complet start_spam_check

Le fonctionnement de l’API de prévisualisation en quatre étapes.

Les prévisualisations s’appuient sur le flux du test de spam : créez un test, envoyez votre e-mail à l’adresse de réception que nous vous renvoyons, puis lisez les rendus appareil par appareil.

  1. 01

    Créer un test de spam

    POST /ext/v2/spam-check avec votre bearer token. La réponse 201 renvoie un id de test et une inbox_address unique.

  2. 02

    Envoyer votre e-mail à l’adresse de réception

    Depuis votre pipeline transactionnel, votre plateforme marketing ou une étape de CI. Le rendu porte sur le message exact que recevrait votre audience.

  3. 03

    Lire les prévisualisations

    GET /ext/v2/spam-check/{id}/client-previews renvoie les rendus appareil par appareil. Interrogez l’API avec un back-off tant que des appareils sont en pending ; les URL apparaissent au fur et à mesure.

  4. 04

    Filtrer les appareils au besoin (facultatif)

    Récupérez le catalogue via GET /ext/v2/client-preview-devices et passez devices pour ne générer qu’un sous-ensemble. Le même test sert aussi /screenshots et /heatmap si vous voulez les extras visuels.

Questions fréquentes sur l’API.

Intégration, filtrage par appareil, accès MCP pour les agents IA et comportement des endpoints de prévisualisation.

Comment obtenir l’accès à l’API ?
L’accès à l’API est fourni avec notre plan White Label, entièrement sur mesure : les limites de tests de spam, de tests de placement en boîte de réception et de prévisualisations d’appareils sont dimensionnées pour votre compte. Contactez un commercial en indiquant le volume attendu et nous définirons l’offre adaptée.
Comment se déroule le flux de prévisualisation ?
Les prévisualisations sont une sous-ressource du test de spam. POST /ext/v2/spam-check renvoie une inbox_address ; vous y envoyez le véritable e-mail ; puis GET /ext/v2/spam-check/{id}/client-previews renvoie une entrée par appareil, avec un status par appareil et les URL des images. Les appareils se terminent indépendamment les uns des autres : interrogez l’API jusqu’à ce que l’ensemble dont vous avez besoin soit completed.
Puis-je ne générer que certains clients ?
Oui. Passez le paramètre de requête devices avec des clés issues de GET /ext/v2/client-preview-devices pour ne générer qu’un sous-ensemble, par exemple uniquement iOS Mail ou uniquement la famille Outlook. Restreindre le rendu restreint aussi ce qu’il consomme sur votre limite de prévisualisations d’appareils.
Les prévisualisations viennent-elles de clients réels ou de simulations ?
De clients réels. Chaque rendu est votre e-mail ouvert dans une copie réelle du client et de l’appareil, puis capturé en image, en mode clair comme en mode sombre. C’est toute la différence entre une API de rendu d’e-mails bâtie sur des clients réels et les simulations par transformation CSS que renvoient la plupart des outils de prévisualisation gratuits.
Puis-je m’en servir pour la QA du rendu en CI ?
C’est le cas d’usage principal. Faites passer une modification de modèle dans le flux depuis une étape de CI, récupérez les rendus de vos clients critiques et joignez-les aux artefacts de build ou comparez-les à l’exécution précédente. Le même test renvoie le score de spam : un seul job couvre donc le rendu et la délivrabilité.
Les agents IA peuvent-ils lancer des prévisualisations d’e-mails ?
Oui. Les endpoints de prévisualisation sont exposés comme outils sur le serveur MCP d’Unspam : get_spam_check_client_previews et list_client_preview_devices, aux côtés des outils de test de spam et de placement en boîte de réception. Connectez Claude, Cursor ou ChatGPT par OAuth et demandez des rendus en langage naturel ; aucune clé à coller.
Quelle différence avec l’endpoint des captures d’écran ?
/spam-check/{id}/screenshots renvoie trois rendus du message selon la largeur d’écran (ordinateur, tablette, mobile). /spam-check/{id}/client-previews affiche l’e-mail dans plus de 50 applications de messagerie réelles, chacune en mode clair et en mode sombre, et détecte donc les défauts propres à un client, comme le moteur Word d’Outlook ou l’inversion d’un logo en mode sombre.
Quelles sont les limites de requêtes ?
La limite publique est de 100 requêtes par minute par IP ou par compte authentifié. L’interrogation des prévisualisations y tient largement avec un back-off normal. S’il vous faut davantage de capacité en pointe, ouvrez le chat en indiquant le débit attendu.

Prêt à générer vos rendus d’e-mails depuis votre propre stack ?

L’accès à l’API est inclus dans le plan White Label. Les tarifs sont sur la page publique, les limites sur mesure se discutent par chat.

Voir les tarifs