API de vista previa de correo.

Renderiza HTML, un correo que nos envíes o una prueba terminada en más de 60 clientes y dispositivos reales vía REST, y consulta en JSON una captura de cada uno.

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

# consulta el id hasta que status sea completed
{
  "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" }'

# las otras dos fuentes
"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"

# respuesta (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
Fuentes de correo
4
Autenticación
Token bearer
Límite de peticiones
100 por minuto

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.

Claro y oscuro como renders separados.

Los clientes que capturamos en modo oscuro tienen un render oscuro aparte con su propia clave de dispositivo, así el logo invertido o el texto ilegible en modo oscuro aparecen en tu pipeline, no en producción.

Acota los renders con el parámetro devices.

Pasa devices con claves del catálogo para renderizar solo los clientes que te importan (solo iOS Mail, solo todos los Outlook) u omítelo para todos los dispositivos de tu plan. Los dispositivos solicitados vuelven en pending; sondea hasta que cada uno esté en completed o failed.

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 JSON: una entrada por dispositivo, con la imagen a tamaño completo, una miniatura y un enlace de descarga.

Cuatro formas de entregar el correo.

Pon email_source en spam-check o inbox-placement y pasa el id de la prueba como source_id, en raw-data con tu propio subject y body en HTML, o en email para obtener un borrador con una inbox_address y enviar allí el mensaje.

El body de raw-data debe ser el HTML completo de un correo diseñado, con al menos 1.000 caracteres y 10 elementos HTML, o se rechaza con 422. Un mensaje enviado a un borrador sin HTML o con muy poco no se renderiza ni se cobra: el borrador conserva su dirección y rellena rejection_reason.

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

Renders con precisión de píxel, dispositivo a dispositivo.

GET /client-previews/{id} devuelve un status general y un array previews[] con una entrada por dispositivo: device_key, device_name, su categoría, el status del dispositivo y las URL de original, thumbnail y download.

Las URL de imagen siguen en null hasta que ese dispositivo está en completed, así que un simple bucle de sondeo vacía todo el conjunto. Un dispositivo también puede terminar en failed, así que detente también con ese estado. GET /client-previews enumera tus vistas previas de raw-data y email; las de pruebas se alcanzan con el client_preview_id de la prueba.

gmail · claro
outlook · oscuro
iphone

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, que es la familia de clientes, como Gmail, iPhone / iPad u Outlook desktop (Windows). 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 y de cuota: cada dispositivo de una solicitud gasta una vista previa en clientes, 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, gastar tres vistas previas y revisar solo esas.

  • 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

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 son asíncronas: elige de dónde sale el correo, crea la vista previa y lee los renders por dispositivo.

  1. 01

    Elige de dónde sale el correo

    Una prueba antispam o de Inbox Placement terminada, tu propio asunto y HTML, o un mensaje que envías a una dirección de borrador.

  2. 02

    Crea la vista previa

    POST /ext/v2/client-previews con email_source y lo que esa fuente necesite. La respuesta 201 trae el id de la vista previa y, para la fuente email, la inbox_address a la que enviar.

  3. 03

    Lee los renders

    Sondea GET /ext/v2/client-previews/{id} con back-off. Cada dispositivo pasa de pending a completed o failed, y sus URL de imagen aparecen a medida que 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. Las claves desconocidas se ignoran, y la llamada solo responde 422 cuando ninguna está disponible.

Los endpoints que hay detrás.

4 endpoints, con el mismo token que el resto de la API. El documento OpenAPI recoge cada parámetro y código de respuesta.

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

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?
Elige una fuente y llama a POST /ext/v2/client-previews: raw-data con subject y body para HTML que no has enviado, email para una dirección de borrador a la que envías un mensaje, o spam-check o inbox-placement con el id de la prueba como source_id. Después, GET /ext/v2/client-previews/{id} devuelve una entrada por dispositivo con su status y las URL de imagen. Los dispositivos terminan por separado, así que sondea hasta que acabe el conjunto que necesitas.
¿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 dispositivo de la solicitud gasta una vista previa de tu asignación, así que acotar cambia tanto lo que recibes como lo que cuesta. Con el plan personalizado el catálogo incluye también renderizados de los dispositivos más recientes: iPhone 18 Pro, la app de Gmail en Pixel 10 y iPhone 16, la app Outlook Microsoft 365 en Windows 11 y macOS, New Outlook for Windows y Gmail web en Chrome.
¿Las vistas previas son clientes reales o simulaciones?
Clientes reales. Cada render es tu correo abierto en una copia real del cliente y del dispositivo, capturado como una captura de pantalla, con un render oscuro aparte para los clientes que capturamos en modo 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?
Es el caso de uso principal. Pasa un cambio de plantilla por la API en un paso de CI, obtén los renders de tus clientes críticos y adjúntalos como artefactos de build o compáralos con la ejecución anterior. Usa una prueba antispam como fuente y la misma ejecución devuelve la puntuación de spam, así un solo job cubre renderizado y entregabilidad.
¿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 renders por viewport (escritorio, tablet, móvil) del mensaje. POST /client-previews renderiza el correo dentro de más de 60 aplicaciones cliente reales, con renders oscuros para los clientes que capturamos en modo oscuro, así detecta fallos propios de cada cliente, como el motor de Word de Outlook o un logo invertido 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.