API del buscador de correo electrónico

La API del Buscador de correo electrónico de ZeroBounce le permite identificar el formato correcto de correo electrónico cuando proporciona un nombre y un dominio de correo.

Luego validamos la dirección de correo electrónico y proporcionamos el estado y subestado correspondientes. Puede utilizar la API para conectar con clientes potenciales o contactos comerciales siempre que pueda brindar los puntos de datos necesarios.

Comenzar

El Buscador de correo electrónico utiliza el nombre y apellido de una persona y un nombre de dominio para probar una variedad de patrones y combinaciones en tiempo real, hasta que identifica un correo electrónico comercial válido. No utiliza ni procesa datos de clientes en ningún momento para auxiliar en esta búsqueda.

Además, también ofrecerá como resultado una lista de los posibles formatos de correo electrónico encontrados para ese dominio. Cada patrón recibirá una calificación de confianza correspondiente que indicará su precisión potencial.

Cada llamada a la API del Buscador de correo electrónico consumirá 20 créditos, si se devuelve un formato de correo electrónico válido.

Si es un suscriptor mensual, la llamada a la API consumirá 1 consulta del Buscador de correo electrónico, si se devuelve un formato válido.

Si el formato devuelto es "desconocido" con la justificación "No se puede identificar el formato de correo electrónico" no se deducirá ningún crédito.

1 crédito se deducirá en los siguientes casos:

  • el dominio se identifica como trampa de spam
  • el dominio se identifica en el supresión global lista
  • el dominio contiene un posible error
  • las partes provistas del nombre son basado en roles
  • el dominio no contiene entradas DNS
  • el dominio contiene una dirección de IP imposible de enrutar
  • el dominio es desechable

Para utilizar la API del Buscador de correo electrónico, utilice la siguiente URL, método y parámetros. Asegúrese de consultar el ejemplo de respuesta correcta que aparece a continuación y los detalles de la respuesta para asegurarse de que la configuración de su API funciona correctamente.

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/guessformat
URL de API de U.S.A.*: https://api-us.zerobounce.net/v2/guessformat

Método: GET

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

  • Parámetro
    Obligatorio
    Descripción
  • api_key
    Sí
    Su clave API, que se encuentra en su cuenta.
  • domain
    Sí
    El dominio de correo electrónico para el que quiere encontrar el formato de correo electrónico.
  • first_name
    No
    El nombre de la persona para la que se busca el formato de correo electrónico. [Opcional]
  • middle_name
    No
    El segundo nombre de la persona para la que se busca el formato de correo electrónico. [Opcional]
  • last_name
    No
    El apellido de la persona para la que se busca el formato de correo electrónico. [Opcional]

Respuesta exitosa


    {
      "email": "john.doe@example.com",
      "domain": "example.com",
      "format": "first.last",
      "status": "valid",
      "sub_status": "",
      "confidence": "HIGH",
      "did_you_mean": "",
      "failure_reason": "",
      "other_domain_formats": [
        {
            "format": "first_last",
            "confidence": "HIGH",
        },
        {
            "format": "first",
            "confidence": "MEDIUM",
        }
      ]
    }

Detalles de la respuesta

  • Propiedades
    Descripción
  • email
    La dirección de correo electrónico resultante identificada por la API.
  • domain
    El nombre de dominio proporcionado.
  • format
    El formato de la dirección de correo electrónico resultante.
  • status
    El estado de validación de la dirección de correo electrónico. Los valores posibles se pueden encontrar en https://www.zerobounce.net/docs/email-validation-api-quickstart#status_codes__v2__
  • sub_status
    El subestado de validación de la dirección de correo electrónico. Los valores posibles se pueden encontrar en https://www.zerobounce.net/docs/email-validation-api-quickstart#status_codes__v2__
  • confidence
    El nivel de confianza que tenemos en el formato proporcionado basado en nuestro motor y base de datos. Valores posibles: BAJA, MEDIA, ALTA, DESCONOCIDA.
  • did_you_mean
    Por ejemplo, una sugerencia en caso de que se utilice un nombre en el campo apellido.
  • failure_reason
    Una causa por el resultado desconocido. Los posibles valores se pueden encontrar en la sección "Posibles causas por el estado desconocido" más abajo.
  • other_domain_formats
    Una lista de formatos de dominio que tenemos para el dominio especificado. Esta lista contiene otros formatos (p. ej., nombre_apellido, nombre, nombre.apellido, etc.) y el nivel de confianza que tenemos en el respectivo formato.

Ejemplos de código

Posibles causas de error por estado desconocido

  • Causa
    Descripción
  • FREE_DOMAIN_ERROR
    La cuenta gratuita no acepta el dominio de correo electrónico.
  • ROLE_BASED_ERROR
    El correo electrónico está basado en funciones, y el filtrado basado en funciones está activo en su cuenta.
  • CANNOT_IDENTIFY_EMAIL_FORMAT
    No se ha encontrado el formato en la base de datos o el motor no ha podido identificarlo.
  • UNEXPECTED_ERROR_OCCURRED_DURING_VALIDATION
    error inesperado
  • DOMAIN_DOES_NOT_ACCEPT_MAIL
    El dominio no acepta correos electrónicos

Otros posibles mensajes de error

La insuficiencia de créditos en ZeroBounce también producirá un error al llamar a la API del Buscador de correo electrónico. Vea el siguiente ejemplo:

"Clave de API no válida o su cuenta se quedó sin créditos".

Puede resolver este error al asegurarse de que haya al menos 20 créditos de ZeroBounce en el saldo de su cuenta antes de realizar la siguiente llamada a la API.

Niveles de confianza de la API del Buscador de correo electrónico

Para cada formato de dirección de correo electrónico que genera la API del Buscador de correo electrónico, asignamos un nivel de confianza correspondiente para indicar la probabilidad de que la dirección esté en uso activo en el dominio de correo electrónico pertinente.

A continuación se indican los niveles de confianza:

  • BAJA: poco probable que esté en uso; alto riesgo.
  • MEDIA nivel medio de confianza; es posible que se utilice el formato.
  • ALTA: el nivel de confianza más alto, es probable que se utilice el formato basado en los resultados de validación.
  • DESCONOCIDA: consulte la sección anterior para posibles errores desconocidos.
  • INDETERMINADO: no se puede determinar el correo electrónico, por lo tanto, se desconoce el formato. No se puede determinar la confianza para un correo electrónico vacío.

La API del Buscador de correo electrónico le permite identificar de manera confiable las direcciones de correo electrónico comerciales para sus posibles clientes potenciales o contactos comerciales.

Podemos identificar patrones potenciales, siempre que nos proporcione el nombre, segundo nombre o apellido de la persona, junto con un posible dominio. Por ejemplo, los nombres de empresas con frecuencia se utilizan para dominios de correo electrónico privados. Luego, validamos el formato del correo electrónico para mantener limpia su lista de correos.

Cada búsqueda del Buscador de correo electrónico se realiza en tiempo real y no utiliza ni procesa datos de clientes. Su privacidad y seguridad siempre serán una prioridad en ZeroBounce.

Si necesita más ayuda para configurar la API del Buscador de correo electrónico o para comprender sus resultados, el equipo de Atención al Cliente de ZeroBounce está disponible 24/7.