API de vista previa de correo.

Renderiza tu correo real en más de 50 clientes de correo y dispositivos reales mediante REST: crea una prueba antispam, envía el mensaje, solicita las vistas previas de esa prueba y recupera renderizados con precisión de píxel en formato JSON, cada uno capturado desde un cliente en vivo en modo claro y oscuro. Los mismos renderizados se exponen como herramientas MCP, para que los agentes de IA puedan ejecutar una prueba de renderizado de correo en lenguaje natural.

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
  ]
}

Las llamadas de vista previa y toda la suite, con una sola clave.

La API de vista previa de correo comparte token, límites de peticiones y facturación con las API de prueba antispam y de Inbox Placement, así que el renderizado se integra en el mismo flujo que ya utilizas.

Vistas previas en clientes

POST /client-previewsTu correo renderizado en más de 50 clientes de correo y dispositivos reales, en modo claro y oscuro, como URL de imágenes que recuperas con el id de la vista previa.

Catálogo de dispositivos

GET /client-preview-devicesTodos los clientes renderizables con su clave y categoría, para construir el filtro devices.

Pruebas antispam

POST /spam-checkLa prueba que lleva las vistas previas: puntuación de spam, análisis forense del remitente y desglose comprobación a comprobación en el mismo resultado.

Herramientas MCP

create_client_previewLos endpoints de vista previa como herramientas MCP para Claude, Cursor, ChatGPT y cualquier cliente MCP remoto.

Por qué los equipos integran las vistas previas en su pipeline.

Capturas reales del cliente, no simulaciones.

Cada vista previa es tu correo abierto en una copia real del cliente y del dispositivo, y luego capturado en pantalla. Sin transformaciones de CSS ni emulación de navegador: la imagen que recibes es exactamente lo que ve un suscriptor en ese cliente.

Modo claro y oscuro en cada cliente.

Cada uno de los más de 50 clientes se renderiza en ambos modos, así que una sola llamada devuelve más de 100 imágenes y el logotipo invertido o el texto ilegible en modo oscuro aparece en tu pipeline, no en producción.

Acota los renders con el parámetro <code>devices</code>.

Pasa devices con claves del catálogo para renderizar solo los clientes que te interesan (solo iOS Mail, solo todos los Outlook), u omítelo para el conjunto completo. Los dispositivos recién solicitados vuelven como pending; sondea hasta que cada uno esté completed.

Herramientas MCP para agentes de IA.

Los endpoints de vista previa se ofrecen como herramientas MCP (create_client_preview, list_client_preview_devices) en el servidor MCP de Unspam, de modo que Claude, Cursor o cualquier cliente MCP puede obtener renders reales del cliente en plena conversación.

Qué devuelven los endpoints de vista previa.

Capturas de clientes reales en formato JSON: una entrada por dispositivo, cada una capturada desde un cliente en vivo en modo claro y oscuro.

01

Vistas previas con precisión de píxel para cualquier prueba.

POST /client-previews con email_source en spam-check y el id de la prueba como source_id inicia los renderizados. Después, GET /client-previews/{id} devuelve un status de nivel superior y un array previews[] con una entrada por dispositivo: device_key, device_name, un status por dispositivo y las URL de los renders original y thumbnail.

original y thumbnail permanecen como null hasta que ese dispositivo pasa a completed, así que un simple bucle de sondeo vacía todo el conjunto. La mayoría de los dispositivos llegan en torno a un minuto.

gmail · claro
outlook · oscuro
iphone
02

Un catálogo de dispositivos que puedes filtrar.

GET /client-preview-devices enumera cada cliente renderizable con su device_key, su nombre visible y su categoría (DESKTOP, MOBILE, WEB). Guárdalo en caché, muéstralo en tu propia interfaz o úsalo para construir el filtro devices de la llamada de renderizado.

Filtrar es cuestión de señal, no de cuota: cada solicitud de vista previa gasta una vista previa en clientes sea cual sea el número de dispositivos, así que un trabajo de CI que se ejecuta con cada cambio de plantilla puede renderizar solo las tres versiones de Outlook que le importan y revisar solo esas.

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

Las mismas vistas previas, invocables por agentes de IA a través de MCP.

Conecta el servidor MCP de Unspam mediante OAuth y tu asistente obtiene las herramientas de vista previa junto a las pruebas antispam y la llegada a la bandeja de entrada. Pídele que renderice la campaña y señale cualquier fallo en el modo oscuro de Outlook, y él mismo encadena las llamadas.

La compatibilidad con MCP significa que tus flujos de trabajo con agentes pueden revisar renderizados de clientes reales sin que nadie abra un panel.

  • Renderiza esta campaña create_client_preview
  • ¿Qué clientes puedes renderizar? list_client_preview_devices
  • Ejecuta la comprobación completa start_spam_check

Cómo funciona la API de vista previa de correo en cuatro pasos.

Las vistas previas se apoyan en el flujo de la prueba antispam: crea una prueba, envía tu correo a la dirección de bandeja de entrada que te devolvemos, solicita las vistas previas de esa prueba y consulta los renderizados de cada dispositivo.

  1. 01

    Crea una prueba antispam

    POST /ext/v2/spam-check con tu bearer token. La respuesta 201 te devuelve un id de prueba y una inbox_address única.

  2. 02

    Envía tu correo a la dirección de la bandeja de entrada

    Desde tu flujo transaccional, tu plataforma de marketing o un paso de CI. Lo que se renderiza es el mensaje exacto que recibiría tu audiencia.

  3. 03

    Solicita las vistas previas en clientes de correo

    POST /ext/v2/client-previews con email_source en spam-check y el id de la prueba como source_id, y luego sondea GET /ext/v2/client-previews/{id} con un back-off mientras los dispositivos están en pending; las URL aparecen a medida que cada uno se completa.

  4. 04

    Filtra los dispositivos cuando lo necesites (opcional)

    Obtén el catálogo con GET /ext/v2/client-preview-devices y pasa devices en el cuerpo del POST para renderizar un subconjunto. La misma prueba también sirve /screenshots y /heatmap si quieres los extras visuales.

Preguntas frecuentes sobre la API.

Integración, filtrado por dispositivo, acceso MCP para agentes de IA y cómo se comportan los endpoints de vista previa.

¿Cómo consigo acceso a la API?
El acceso a la API está incluido en el plan personalizado, que contratas en línea: elige el volumen mensual de cada prueba en la página de precios, desde un mínimo de $5, y las tarifas bajan a medida que creces. Puedes integrarlo en tu propio producto y revenderlo con tu propia marca. Para cualquier otra cosa, abre un ticket de soporte.
¿Cómo funciona el flujo de vista previa de correo?
Las vistas previas se solicitan para una prueba antispam. POST /ext/v2/spam-check devuelve un inbox_address; envías el correo real a esa dirección; luego POST /ext/v2/client-previews con email_source en spam-check y el id de la prueba como source_id inicia los renderizados, y GET /ext/v2/client-previews/{id} devuelve una entrada por dispositivo, con status por dispositivo y las URL de las imágenes. Los dispositivos se completan de forma independiente, así que sondea hasta que el conjunto que necesitas esté completed. Para previsualizar un HTML que no has enviado, pon email_source en raw-data y pasa un subject y un body.
¿Puedo renderizar solo clientes concretos?
Sí. Pasa devices en el cuerpo de POST /ext/v2/client-previews con claves de GET /ext/v2/client-preview-devices para renderizar un subconjunto, por ejemplo solo iOS Mail o solo la familia Outlook. Cada solicitud de vista previa gasta una vista previa en clientes de tu asignación sea cual sea el número de dispositivos, así que acotar cambia lo que recibes, no lo que cuesta.
¿Las vistas previas son clientes reales o simulaciones?
Clientes reales. Cada renderizado es tu correo abierto en una copia real del cliente y del dispositivo, capturado como una captura de pantalla, tanto en modo claro como oscuro. Esa es la diferencia entre una API de renderizado de correo construida sobre clientes reales y las simulaciones por transformación de CSS que devuelven la mayoría de las herramientas de vista previa gratuitas.
¿Puedo usarla para QA de renderizado en CI?
Ese es el caso de uso principal. Pasa un cambio de plantilla por el flujo en un paso de CI, recoge los renderizados de tus clientes críticos y adjúntalos como artefactos de build o compáralos con la ejecución anterior. La misma prueba devuelve la puntuación de spam, así que un solo trabajo cubre el renderizado y la entregabilidad a la vez.
¿Pueden los agentes de IA ejecutar vistas previas de correo?
Sí. Los endpoints de vista previa se exponen como herramientas en el servidor MCP de Unspam: create_client_preview, list_client_previews y list_client_preview_devices, junto a las herramientas de prueba antispam y de Inbox Placement. Conecta Claude, Cursor o ChatGPT mediante OAuth y pide renderizados en lenguaje natural; sin claves que pegar.
¿En qué se diferencia esto del endpoint de capturas de pantalla?
/spam-check/{id}/screenshots devuelve tres renderizados de viewport (escritorio, tablet, móvil) del mensaje. POST /client-previews renderiza el correo dentro de más de 50 aplicaciones cliente reales, cada una en modo claro y oscuro, de modo que detecta fallos específicos de cada cliente, como el motor Word de Outlook o la inversión de un logo en modo oscuro.
¿Cuáles son los límites de frecuencia?
El límite público es de 100 solicitudes por minuto por IP o por cuenta autenticada. El sondeo de vistas previas encaja cómodamente dentro de él con un back-off normal. Si necesitas un límite más alto, abre un ticket de soporte con el rendimiento que esperas.
¿Puedo integrarlo en mi propio producto y revenderlo?
Sí, con el plan personalizado. Cada vista previa llega en JSON con una URL de imagen por cliente de correo y dispositivo, así que puedes mostrar los renderizados en tu propia interfaz y revenderlos a tus clientes con tu propia marca.

¿Listo para renderizar correos desde tu propio stack?

El acceso a la API está incluido en el plan personalizado, que se contrata en línea desde un mínimo de $5 al mes. Intégralo en tu propio producto y revéndelo con tu propia marca.

Ver precios