API de comprobación de spam del correo.

Crea una prueba antispam vía REST, envía tu correo a la dirección que devuelve y consulta en JSON una puntuación de 0 a 100 con todas las comprobaciones que hay detrás.

curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# devuelve el id del test y la dirección a la que enviar
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# envía tu correo a esa dirección y luego lee el resultado
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# respuesta (200)
{
  "status": "completed",
  "score": 85,
  "sender": "you@yourdomain.com",
  "sender_ip": "192.0.2.1",
  "results": [
    { "id": "spf", "value": [ ... ] },
    { "id": "dkim", "value": [ ... ] },
    { "id": "ip_blacklist", "value": [ ... ] }
  ],
  "report_url": "https://unspam.email/results/2Bl8rzTFN6VV"
}
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV/heatmap \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# respuesta (200)
{
  "focus": { "desktop": { "url": "https://…/focus.png", "status": "completed" } },
  "attention": { "desktop": { "url": null, "status": "pending" } }
}
Endpoints
6
Tipos de comprobación por prueba
17
Autenticación
Token bearer
Límite de peticiones
100 por minuto

Por qué los equipos integran Unspam como su API de comprobación de spam.

Flujo asíncrono: crea y luego lee.

POST crea una prueba y te devuelve una dirección de bandeja de entrada única. Envía allí tu correo real desde tu infraestructura y luego haz GET del resultado, de modo que se puntúa el mensaje que tu plataforma envía de verdad.

Puntuación de 0 a 100, más detalle del remitente y de la autenticación.

Cada prueba completada devuelve la puntuación, el host del remitente, la IP del remitente, el message-ID y un array results[] con 17 tipos de comprobación, desde SPF, DKIM y DMARC hasta listas negras, SpamAssassin y enlaces rotos. Una sola lectura cubre el veredicto completo.

Capturas, vistas previas en clientes y mapas de calor con IA, todo integrado.

/screenshots devuelve renders de la prueba en escritorio, tablet y móvil, y /heatmap devuelve mapas de foco y atención con IA para escritorio. Pasa el mismo id de prueba a POST /client-previews para renderizar el correo en más de 60 clientes y dispositivos reales.

Cada prueba de la API, en una lista paginada.

GET /spam-check?page=N&per_page=15 devuelve las pruebas en curso y completadas que creaste con la API, con id, estado, puntuación, marcas de tiempo y el report_url alojado. Muestra resultados anteriores en tu propio panel sin repetir la prueba.

Qué devuelve cada comprobación de spam.

Una puntuación de entregabilidad de 0 a 100, el desglose por comprobación que la determina y los extras visuales y con IA para tus pipelines de QA.

Una única puntuación de 0 a 100 para el salto de entregabilidad.

El campo score es un número entero de 0 a 100 que agrupa cada señal (autenticación, contenido, listas negras, cabeceras) en una sola cifra sobre la que un paso de CI puede ramificar. Los informes de Unspam leen de 90 a 100 como excelente, de 70 a 89 como sólida, de 50 a 69 como en riesgo y de 0 a 49 como riesgo alto, y tratan un fallo de SPF, DKIM o DMARC como riesgo alto sea cual sea la cifra, así que ramifica también sobre results[].

Combínalo con report_url si tu equipo necesita el desglose visual completo: ambos campos llegan en la misma respuesta.

Inbox
85/100
0: spam 100: limpio

Un desglose comprobación por comprobación en el mismo payload.

El array results[] enumera cada comprobación que ejecutó el motor: spf, dkim, dmarc, bimi, ip_blacklist, domain_blacklist, spamassassin, subject_line, html_best_practice, broken_links y más. Cada entrada tiene un id estable y las señales que hay detrás, cada una con su propio status.

Sin un endpoint aparte para obtener los veredictos comprobación por comprobación. Un solo GET, la historia completa.

  • Comprobación de SPF spf
  • Comprobación de DKIM dkim
  • Comprobación de DMARC dmarc
  • Asunto subject_line
  • Enlaces rotos broken_links
  • Buenas prácticas de HTML html_best_practice

Capturas de pantalla y mapas de calor con IA en la misma prueba.

GET /spam-check/{id}/screenshots devuelve las URL de las imágenes de tu correo en escritorio, tablet y móvil, con null en los dispositivos aún en curso. Añádelas a los artefactos de tu CI o a tu panel de remitente sin más procesamiento.

GET /spam-check/{id}/heatmap devuelve mapas de calor de foco y atención generados por IA para escritorio, cada uno con su url y su status, así ves dónde mirarán tus lectores antes de lanzar el próximo envío.

Escritorio
Tableta
Móvil

Cómo funciona la API en cuatro pasos.

La API de comprobación de spam es asíncrona: creas una prueba, envías tu correo a la dirección de bandeja de entrada que te devolvemos y luego consultas el veredicto.

  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

    Desde tu flujo transaccional, tu plataforma de marketing o un paso de CI. El mensaje pasa por nuestro motor de prueba antispam, que lo retiene para analizarlo.

  3. 03

    Lee el veredicto

    GET /ext/v2/spam-check/{id} pasa de pending_inbox_message a spam_check_running y a completed, con la puntuación, los datos del remitente y results[]. Sondea con back-off o conéctalo a un worker de trabajos, y detente también con error u outdated.

  4. 04

    Obtén capturas, vistas previas y mapas de calor (opcional)

    /spam-check/{id}/screenshots para los renders de los tres dispositivos, /spam-check/{id}/heatmap para los mapas de foco y atención con IA en escritorio, y POST /client-previews con el mismo id de prueba para ver el correo en más de 60 clientes reales (consulta la API de vistas previas de correo). Cada uno consume su propia asignación: las capturas y el mapa de calor gastan una unidad la primera vez que los pides, y una petición de vista previa gasta una vista previa de dispositivo por cada dispositivo que renderiza. Pedir el mapa de calor antes que las capturas también gasta una unidad de captura, porque el mapa se dibuja sobre la captura de escritorio.

Los endpoints que hay detrás.

6 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
Spam Check 5 llamadas
  • GET /spam-check
  • POST /spam-check
  • GET /spam-check/{id}
  • GET /spam-check/{id}/heatmap
  • GET /spam-check/{id}/screenshots
Account 1 llamada
  • GET /status

Preguntas frecuentes sobre la API.

Integración, facturación, límites de peticiones y qué devuelve el endpoint de comprobación de spam.

¿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.
¿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. Eso cubre la mayoría del tráfico en producción. Si necesitas un límite más alto, abre un ticket de soporte indicándonos tu rendimiento previsto.
¿Cómo funciona el flujo de crear y luego leer?
Son dos llamadas. POST /ext/v2/spam-check devuelve una inbox_address; tu plataforma de envío entrega el correo real a esa dirección; después GET /ext/v2/spam-check/{id} devuelve el veredicto en cuanto status es completed. Espacia las peticiones con retardo exponencial o usa un worker de trabajos, y detente también con error u outdated.
¿Puedo consultar mi cuota restante desde la API?
GET /ext/v2/status devuelve tu correo y tu suscripción: nombre del plan, precio, fecha del próximo pago y los límites restantes (spam_checks, inbox_placements, screenshots, heatmaps, client_previews), además de los indicadores has_history, has_ai_assistant, has_api y has_mcp. Útil para mostrar el consumo en tu propio panel de administración.
¿Qué precisión tiene la puntuación de spam?
La puntuación refleja cómo valoran el mensaje nuestras comprobaciones. La entrega real sigue dependiendo de la reputación de envío, la higiene de la lista y la interacción de los destinatarios. La API te da la señal de contenido y autenticación, no una garantía de llegada a la bandeja de entrada.
¿Puedo llamar a la API desde cualquier lenguaje?
Sí. La API es REST + JSON sobre HTTPS. Funciona con cualquier cliente HTTP (curl, Node, Python, Go, Ruby, PHP, …). No hay ningún SDK obligatorio; la autenticación es una sola cabecera Authorization: Bearer YOUR_API_TOKEN.
¿Hay un entorno de pruebas o una prueba gratuita?
No hay un entorno de pruebas (sandbox) para la API. El plan Free ejecuta las mismas pruebas en el panel, así que puedes valorar los resultados antes de pagar, y el plan personalizado empieza en $5 al mes con un reembolso de 14 días, así que probar la API en un piloto real sale barato.
¿Puedo integrarlo en mi propio producto y revenderlo?
Sí, con el plan personalizado. Cada prueba antispam llega en JSON con su puntuación y el resultado de cada comprobación, así que puedes mostrarla en tu propia interfaz y revenderla a tus clientes con tu propia marca.

¿Listo para integrar Unspam en tu 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.