API de comprobación de spam del correo.

Crea una prueba antispam vía REST, envía tu correo a la dirección de bandeja de entrada que te devolvemos y luego consulta una puntuación de entregabilidad de 0 a 100 con análisis forense del remitente, desglose por comprobación, capturas de pantalla y mapas de calor con IA en formato JSON.

POST /ext/v2/spam-check
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"
}

# now send your email to inbox_address
# from your sending platform.
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "id": "2Bl8rzTFN6VV",
  "status": "completed",
  "score": 85,
  "sender": "you@yourdomain.com",
  "sender_ip": "192.0.2.1",
  "results": [
    { "id": "spf", ... },
    { "id": "dkim", ... },
    { "id": "dmarc", ... }
  ],
  "report_url": "https://unspam.email/results/2Bl8rzTFN6VV"
}

Cuatro tipos de petición. Una clave de API.

Una sola clave cubre los cuatro endpoints. Empieza con POST /spam-check para la puntuación, el análisis del remitente y el desglose de cada comprobación, y reutiliza la misma ejecución para enviar a la lista de semillas, obtener previsualizaciones reales en clientes o pedir el mapa de calor de atención.

Pruebas antispam

POST /spam-checkPuntuación de spam, análisis forense del remitente y desglose por comprobación. Pensada para plataformas de envío y equipos de CRM.

Inbox Placement

POST /inbox-placementEnvía a nuestra lista de semillas y obtén la carpeta de cada buzón (bandeja de entrada / promociones / spam) más la exposición a listas negras.

Vistas previas en clientes

POST /client-previewsTu correo renderizado en más de 50 clientes y dispositivos reales, en modo claro y oscuro. Consulta la API de vista previa de correo.

Mapas de calor del correo

GET /spam-check/{id}/heatmapMapas de calor de foco y atención generados con IA para los tres tamaños de dispositivo.

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

Flujo asíncrono: crea y luego lee.

Con POST creas una prueba y recibes una dirección de bandeja de entrada única. Envía ahí tu correo real desde tu infraestructura actual y luego recupera el resultado con GET. Sin límites de tamaño, sin parches de MIME.

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 las comprobaciones de SPF/DKIM/DMARC y de contenido. Una sola lectura cubre el veredicto completo.

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

Cada prueba antispam incluye dos subrecursos: /screenshots devuelve renderizados para escritorio, tablet y móvil, y /heatmap devuelve mapas de foco y atención generados con IA para ese mismo correo. Pasa el mismo id de prueba a POST /client-previews para renderizar el correo en más de 50 clientes de correo y dispositivos reales.

Cada prueba, guardada y paginada.

Las pruebas antispam anteriores quedan archivadas. GET /spam-check?page=N&per_page=15 devuelve la lista paginada con id, estado, puntuación, marcas de tiempo y la report_url alojada. Incrusta los resultados históricos en tu propio panel sin volver a ejecutar 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.

01

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
02

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, densidad de palabras de spam, reputación de los enlaces, ratio de imagen a texto y mucho más. Cada entrada tiene un id estable que puedes vincular a tu propio panel.

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
  • Palabras de spam spam_words
  • Reputación de enlaces link_rep
  • Proporción imagen / texto img_ratio
03

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 renderizado en escritorio, tablet y móvil. Añádelas a los artefactos de tu CI o al panel de tu remitente sin ningún procesamiento adicional.

GET /spam-check/{id}/heatmap devuelve mapas de calor de foco y atención generados por IA en esos mismos tres dispositivos, así ves exactamente 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} devuelve la puntuación, el análisis forense del remitente, el message-ID y el array results[] en cuanto status pasa a "completed". Consúltalo con retardo exponencial o conéctalo a un worker de trabajos.

  4. 04

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

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

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 === "completed". La mayoría de las comprobaciones terminan en unos segundos, así que espacia las peticiones con retardo exponencial o usa un worker de trabajos.
¿Puedo consultar mi cuota restante desde la API?
GET /ext/v2/status devuelve tu correo, el nombre de tu suscripción y el mapa de límites (spam_check, inbox_placement, screenshots, heatmaps, has_history, has_ai_assistant). Útil para mostrar el uso 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 nuestros motores y cuentas de semillas. 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 Inbox Placement.
¿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.

Ver precios