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_check", ... },
    { "id": "dkim_check", ... },
    { "id": "dmarc_check", ... }
  ],
  "report_url": "https://unspam.email/email-test/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.

Ubicación en bandeja de entrada

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

GET /spam-check/{id}/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 tres subrecursos: /screenshots devuelve renderizados para escritorio, tablet y móvil, /client-previews renderiza el correo en más de 50 clientes y dispositivos reales, y /heatmap devuelve mapas de foco y atención generados con IA para ese mismo correo.

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 agrupa cada señal (autenticación, contenido, listas negras, cabeceras) en un solo número sobre el que un paso de CI puede ramificar. 80 o más es saludable, entre 50 y 70 es arriesgado, y por debajo de 50 lo más probable es que acabe en spam.

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_check
  • Comprobación de DKIM dkim_check
  • Comprobación de DMARC dmarc_check
  • 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 CDN 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}/client-previews para el correo en más de 50 clientes reales (consulta la API de vista previa de correo) y /spam-check/{id}/heatmap para los mapas de foco y atención con IA. Todos comparten el mismo id de prueba, así que no tienes que llevar una contabilidad de créditos extra en tu código.

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 se incluye en nuestro plan White Label, que es totalmente personalizado: los límites de pruebas antispam, pruebas de ubicación en bandeja de entrada, capturas de pantalla y mapas de calor se ajustan a tu cuenta. Habla con ventas indicándonos tu volumen previsto y definiremos lo que mejor te encaje.
¿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 mayor capacidad de picos o un canal dedicado, abre el chat 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 ubicación en 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 publicamos una prueba de API de autoservicio. Habla con ventas para obtener acceso de evaluación. La mayoría de los equipos hacen primero un piloto con la herramienta web gratuita para confirmar que la lógica de la prueba encaja con su caso de uso.

¿Listo para integrar Unspam en tu stack?

El acceso a la API está incluido en el plan White Label. Precios en la página pública, límites a medida por chat.

Ver precios