Especificaciones

Para acceder a los archivos de la base de datos desde las rutas, debe proporcionar unas credenciales válidas. El nombre de usuario y la contraseña son iguales a su Clave API personal, que puede obtener en la página Mis productos.

La base de datos está disponible en los siguientes formatos

• Dominios de correo electrónico puntuados: una lista que se actualiza a diario con dominios de correo electrónico que incluyen una puntuación de confianza de 0 a 100, una clasificación, un indicador que señala si se han detectado registros MX y la fecha de la última comprobación de registros MX.
• • Bandas de clasificación: desechable (92–100), probablemente desechable (62–92), desconocido (42–62), libre (0–42).
  • Ruta base: https://download.whoisxmlapi.com/datafeeds
  • Formato: «disposable-emails-scored.full.%DATE%.csv» y «disposable-emails-scored.full.%DATE%.json», por ejemplo, «disposable-emails-scored.full.2026-07-28.csv».
  • Cada día se publica un nuevo archivo a las 13:00 UTC.
  • Ejemplos: disposable-emails-scored.full.2026-07-28.sample.csv, disposable-emails-scored.full.2026-07-28.sample.json
  • Campos del archivo:

    Los archivos JSON contienen los mismos campos en camelCase: domain, confidenceScore, classification, mxSeen, mxChecked, modelVersion.

    Campo	Tipo	Descripción
    dominio	cadena	El dominio, en minúsculas. Punycode (xn--) para dominios internacionalizados.
    puntuación_de_confianza	número entero, de 0 a 100	Nivel de confianza del modelo en que el dominio es desechable. Los valores más altos indican una mayor probabilidad de que sea desechable. Se deja en blanco en el caso de un pequeño porcentaje de residuos (~0,1 %) cuyos servidores de nombres no responden de forma permanente.
    clasificación	cadena	Una de las siguientes opciones: «desechable», «probablemente desechable», «gratis» o «desconocido».
    mx_seen	booleano	Si se detectó una infraestructura de correo activa en la última comprobación. «Vacío» significa que no está configurada, no que «no haya servidor de correo».
    mx_checked	fecha	La última vez que se comprobó la validez de MX, en el formato estándar (AAAA-mm-dd), p. ej., 2026-07-22.
    versión_del_modelo	cadena	Huellas digitales del modelo de puntuación que generó la puntuación. Queda en blanco en las filas que aún no se han vuelto a puntuar con un modelo marcado.

• Dominios de correo electrónico desechables: una lista actualizada diariamente de dominios de correo electrónico desechables.
• • Ruta base: https://download.whoisxmlapi.com/datafeeds
  • Formato: "disposable-emails.full.%DATE%.txt", por ejemplo, "disposable-emails.full.2020-01-16.txt".
  • Cada día, a las 01:00 UTC, se publica un nuevo archivo.
  • Número de dominios disponibles: más de 162 000
  • Ejemplo: disposable-emails.full.2026-07-28.sample.txt
• Dominios de correo electrónico gratuitos: una lista actualizada diariamente de dominios de correo electrónico gratuitos.
• • Ruta base: https://download.whoisxmlapi.com/datafeeds
  • Formato: "free-emails.full.%DATE%.txt", por ejemplo, "free-emails.full.2020-01-16.txt".
  • Cada día, a las 01:00 UTC, se publica un nuevo archivo.
  • Número de dominios gratuitos: más de 192 000
  • Ejemplo: free-emails.full.2026-07-28.sample.txt

Cómo descargar los archivos datafeed

Herramienta de descompresión recomendada

Cuando trabaje con archivos comprimidos de gran tamaño, le recomendamos que utilice unpigz en lugar de gunzip. Según nuestras pruebas de rendimiento, gunzip puede ser casi dos veces más lento que unpigz en el caso de archivos de gran tamaño. Por este motivo, unpigz es la herramienta de descompresión preferida.

Descarga a través de HTTPS

• Ruta base: https://download.whoisxmlapi.com/datafeeds/
• Nombre de usuario y contraseña: igual a su clave API personal, que puede obtener en la página Mis productos.
• Carpeta: Disposable_Email_Domains

Nota: si la lista de direcciones IP autorizadas está activada en la configuración de su cuenta, solo se aceptarán descargas HTTPS procedentes de las direcciones IP incluidas en dicha lista; el resto de solicitudes se rechazarán con el código de error 403: «Su dirección IP no figura en la lista de direcciones autorizadas».

Descarga a través de FTP

• Anfitrión: datafeeds.whoisxmlapi.com
• Puerto: 21210
• Nombre de usuario: 'user'
• Contraseña: igual a su clave API personal, que puede obtener en la página Mis productos .
• Ruta base: ftp://datafeeds.whoisxmlapi.com:21210
• Carpeta: Disposable_Email_Domains

Nota: si la lista de direcciones IP autorizadas está activada en la configuración de su cuenta, se aplica tanto a las descargas de fuentes de datos como a las llamadas a la API: las solicitudes FTP, FTPS y HTTPS procedentes de direcciones IP que no figuren en la lista se rechazan con el código de error 403 «Su dirección IP no figura en la lista de direcciones autorizadas». Añada las direcciones IP de todos los equipos que descarguen las fuentes de datos antes de activarla.

Descarga a través de FTPS

Más información sobre la conexión FTPS: https://en.wikipedia.org/wiki/FTPS.

Nuestro servidor FTP admite el cifrado FTP explícito sobre TLS. Puede configurar su cliente FTP para usar FTP explícito a través de Encriptación TLS para comunicaciones seguras .

Se accede a nuestro servidor FTPS utilizando las mismas rutas y claves API que un servidor FTP normal. Las instrucciones correspondientes se describen más arriba. Para conectarse a través de FTPS, seleccione la opción de cifrado "Require explicit FTP over TLS" en su cliente FTP, si lo admite. Ejemplo de configuración de FileZilla: