API de lista negra de correo - Deteccion de correos desechables

API de Lista Negra de Correo Electrónico

Protege tus formularios de registro de correos desechables. Nuestra API comprueba contra mas de 186.000 dominios de correo temporal conocidos, actualizados diariamente de 5 fuentes de datos de codigo abierto.

{ "email": "[email protected]", "domain": "10minutemail.com", "local_part": "user", "valid_syntax": true, "checks": { "disposable": { "is_disposable": true, "confidence": "high" }, "role": { "is_role": false, "role_type": null }, "free": { "is_free": false, "provider": null }, "mx": { "has_mx": true, "records": ["mx1.10minutemai ...

Categoría Seguridad y correo electrónico

Endpoints 4

Características principales 8

Preguntas frecuentes 5

Utilizado por personas en empresas increíbles.

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Qué te ayuda a lanzar esta API

Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.

Flujos de producto

Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.

Automatización de analistas

Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.

Datos JSON limpios

Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.

IA y operaciones

Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.

Flujo de integración

Un camino simple desde la primera solicitud hasta un uso repetible en producción.

Autentica una vez

Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.

Consulta con ejemplos

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Opera y monitoriza

Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.

Kit para desarrolladores

Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.

Esquema OpenAPI

Genera clientes o inspecciona cada forma de solicitud y respuesta.

Colección Postman

Importa solicitudes listas para pruebas manuales y traspaso al equipo.

SDKs y CLI

Usa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.

Integración MCP

Expón inteligencia de dominios a agentes de IA y asistentes internos.

Mapa de parámetros y respuesta

Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.

Parámetros de solicitud

Parámetro

emailtargetslimitoffsetformat

Campos de respuesta

Respuesta de ejemplo

emaildomainlocal_partvalid_syntaxcheckschecks.disposablechecks.disposable.is_disposablechecks.disposable.confidencechecks.rolechecks.role.is_rolechecks.role.role_typechecks.free

Cobertura de estados

Códigos de estado HTTP

200400401402429

Endpoints

GET /v1/email/check

Créditos: 1Autenticación: Autenticación requerida

POST /v1/email/check/bulk

Créditos: 1/itemAutenticación: Autenticación requerida

targets

GET /v1/email/blacklist

Créditos: 0Autenticación: Autenticación requerida

GET /v1/email/blacklist/download

Créditos: 0Autenticación: Autenticación requerida

format

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

Estado del servicio Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

Créditos gratuitos Regístrate Gratis

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Activo Solicitud de ejemplo

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Características principales

Mas de 186.000 dominios desechables

Base de datos completa agregada de 5 repositorios de codigo abierto, actualizada diariamente.

Puntuacion de confianza

Niveles de confianza alto, medio y bajo basados en verificacion cruzada de fuentes.

Deteccion basada en rol

Identifica admin@, support@, info@ y otras direcciones basadas en rol.

Deteccion de proveedores gratuitos

Marca Gmail, Yahoo, Outlook y otros proveedores de correo electronico gratuitos.

Validacion de registro MX

Verifica que el dominio puede realmente recibir correo electronico.

Comprobacion DNSBL

Comprueba el dominio contra las listas negras de Spamhaus, SURBL y URIBL.

Puntuacion de riesgo

Puntuacion de riesgo agregada 0-100 con clasificacion baja/media/alta.

API masiva

Comprueba hasta 100 correos electronicos en una sola solicitud de API con estadisticas resumidas.

Solicitud de ejemplo

GET /v1/email/check bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/[email protected]"

Respuesta de ejemplo

200 OK json

{
  "email": "[email protected]",
  "domain": "10minutemail.com",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": { "is_disposable": true, "confidence": "high" },
    "role": { "is_role": false, "role_type": null },
    "free": { "is_free": false, "provider": null },
    "mx": { "has_mx": true, "records": ["mx1.10minutemail.com"] },
    "dnsbl": { "listed": false, "lists": [], "threat_level": "none" }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": ["DISPOSABLE_DOMAIN"],
  "checked_at": "2026-03-29T18:00:00.000Z"
}

Preguntas frecuentes

¿Que es un correo electronico desechable?

Los correos electronicos desechables (tambien llamados temporales, de usar y tirar o de un solo uso) son direcciones que se autodestruyen despues de un corto tiempo. Servicios como 10minutemail, guerrillamail y tempmail se utilizan comunmente para eludir la verificacion de registro.

¿Por que deberia bloquear los correos electronicos desechables?

Los usuarios con correos electronicos desechables tienen un compromiso casi nulo y a menudo abusan de tu servicio. Bloquearlos mejora la calidad de los registros, reduce las cuentas falsas y ahorra costes en el envio de correos electronicos.

¿Con que frecuencia se actualiza la lista negra?

Nuestra base de datos se actualiza diariamente. Accede a la lista completa mediante GET /v1/email/blacklist.

¿Puedo acceder a la lista negra completa?

¡Si! Usa GET /v1/email/blacklist para obtener el feed paginado con hasta 10.000 dominios por solicitud. Incluye parametros offset y limit para paginar por la lista completa.

¿En que se basa la puntuacion de riesgo?

Dominio desechable (+80), sin registros MX (+50), listado en DNSBL (+60), direccion basada en rol (+20), proveedor gratuito (+10). Las puntuaciones estan limitadas a 100 y se clasifican como baja (0-39), media (40-69) o alta (70-100).

Herramientas y Recursos Relacionados

Códigos de estado HTTP

Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.

OK 200

Solicitud correcta

Solicitud incorrecta 400

Parámetros no válidos

No autorizado 401

Clave de API o sesión ausente o no válida.

Pago requerido 402

No tienes créditos suficientes para ejecutar esta solicitud.

Demasiadas solicitudes 429

Límite de frecuencia superado

Empieza a bloquear correos desechables

Empezar gratis Ver documentación Probar la herramienta gratuita