Documentación de la API pública del Evaluador de listas

Pruebe nuestro validador de correo electrónico

Descubra cómo ZeroBounce mejora la verificación de lista de correo electrónico masivo con una precisión del 99% en los resultados. Suba un archivo CSV o TXT y ZeroBounce evaluará su lista de forma gratuita.

Si bien este es un servicio público gratuito, existen limitaciones para garantizar que, una vez que evalúe la lista, también la valide a través de ZeroBounce. La API pública del Evaluador de listas está disponible para uso ilimitado para aquellos que gastan créditos al validar con nosotros.

El uso del punto final de la API de Evaluador de listas proporciona resultados en tiempo real y le da una visión general de la salud de su lista de correo electrónico, antes de enviarla a través de nuestra validación de correo electrónico integral. Los resultados se devuelven en porcentajes y se requiere un mínimo de 100 correos electrónicos para su evaluación.

Así es cómo funciona el proceso:

  1. Comienza enviando tu lista de correos electrónicos al punto final de la API de List Evaluator (como se muestra en el gráfico anterior y también en el texto a continuación).

    Por favor, reemplaza tu_api_key con tu clave API de tu cuenta.

    Puedes encontrar tu clave API de ZeroBounce visitando la página de configuración de la API desde tu panel de control. También puedes crear una nueva clave API si es necesario. Si no estás seguro de cómo interactuar con nuestra API, consulta nuestra detallada documentación de la API.

  2. Una vez que completemos la evaluación gratuita de tu lista, te enviaremos una respuesta indicándote el porcentaje de correos electrónicos riesgosos en tu lista. Si la tasa de rebote estimada es baja, puedes finalizar el proceso aquí y guardar tus créditos para la próxima limpieza.

  3. Si la tasa estimada de rebote de correos electrónicos es alta, puedes dirigir tu lista de inmediato al punto final de la API del validador de correo electrónico para su validación.

Este flujo de trabajo mejorado te proporciona más información sobre tu lista de correo electrónico para que puedas hacer un uso más efectivo de tus créditos de validación de correo electrónico.

Si necesita que lo orienten en el uso de la API, no dude en comunicarse con nuestro equipo de Atención al Cliente 24/7.

Punto de enlace de la API:

POST https://bulkapi.zerobounce.net/v2/listevaluator/

El tipo de contenido del cuerpo debe ser multipart/form-data.

Datos del cuerpo

  • Parameter
    Description
  • file
    Archivo en formato cvs o txt. Contenidos del archivo enviado en forma de array de bytes. El encabezado del contenido es el tipo de "text/csv". (Requerido)
  • api_key
    Su clave API, que se encuentra en su cuenta. (Requerida)
  • email_address_column
    El índice de columna de la dirección de correo electrónico en el archivo. El índice comienza a partir de 1 (obligatorio).

RESPUESTA DE PUNTO FINAL

Respuesta exitosa (código de estado: 201 CREATED)
Repuesta de error (código de estado: 4xx, 5xx)

GET https://bulkapi.zerobounce.net/v2/listevaluator/<file_id>/?api_key=api_key

Parámetros de consulta de la URL

  • Parameter
    Description
  • file_id
    ID de archivo proporcionado en la respuesta de la solicitud POST (obligatorio)
  • api_key
    Su clave API, que se encuentra en su cuenta. (Requerida)

RESPUESTA DE PUNTO FINAL

Respuesta exitosa (código de estado: 200 OK)
El archivo # se está procesando
Respuesta exitosa (código de estado: 200 OK)
El archivo # está completo
Repuesta de error (código de estado: 4xx, 5xx)


POST https://bulkapi.zerobounce.net/v2/send-evaluated-file/

El tipo de contenido del cuerpo debe ser multipart/form-data.

Datos del cuerpo

  • Parameter
    Description
  • file
    Archivo en formato cvs o txt. Contenidos del archivo enviado en forma de array de bytes. El encabezado del contenido es el tipo de "text/csv". (Requerido)
  • api_key
    Su clave API, que se encuentra en su cuenta. (Requerida)

RESPUESTA DE PUNTO FINAL

Respuesta exitosa (código de estado: 201 CREATED)
Repuesta de error (código de estado: 4xx, 5xx)

LÍMITES DE VELOCIDAD DEL EVALUADOR DE LISTAS

Nuestro evaluador de listas es un servicio gratuito y está sujeto a límites de velocidad en proporción a la cantidad de créditos adquiridos para su cuenta. Se debe enviar un mínimo de 100 correos electrónicos para su evaluación.

Solicitudes de clave de API incorrectas a https://bulkapi.zerobounce.net/v2/listevaluator/ Realizar solicitudes incorrectas de clave de API 200 veces en 1 hora generará un bloqueo temporal de 1 horas.