API del buscador de correo electrónico

La API de Email Finder te permite buscar nuevas direcciones de correo electrónico empresariales utilizando nuestras tecnologías propietarias.

La API de Email Finder utiliza el nombre y apellido de una persona, junto con un dominio o nombre de empresa, para probar en tiempo real una variedad de patrones y combinaciones hasta identificar un correo electrónico empresarial válido. No utiliza ni procesa datos de clientes en ningún momento para ayudar en esta búsqueda.

Nota sobre privacidad y seguridad: Las búsquedas realizadas por la API de Email Finder se efectúan en tiempo real y no utilizan datos de clientes almacenados o procesados. La privacidad y seguridad del cliente son y siempre serán nuestra máxima prioridad.

Cómo utilizar la API de Email Finder

Antes de comenzar, asegúrate de que tu cuenta tenga suficientes créditos o consultas por suscripción. Una búsqueda exitosa con la API de Email Finder consumirá una (1) consulta por suscripción o 20 créditos.

No se deducen créditos ni consultas si la respuesta es indeterminada.

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.
  • company_name
    Sí
    El nombre de la empresa para la cual buscar 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]

Email_Finder_API_Note

Respuesta exitosa


    {
      "email": "john.doe@example.com",
      "email_conficence": "high",
      "domain": "example.com",
      "company_name": "Example Company LLC",
      "did_you_mean": "",
      "failure_reason": "",
    }

Detalles de la respuesta

  • Propiedades
    Descripción
  • email
    La dirección de correo electrónico resultante identificada por la API.
  • email_confidence
    El nivel de confianza que tenemos de que el correo electrónico existe. Posibles valores: ALTO, MEDIO, BAJO.
  • domain
    El nombre de dominio proporcionado.
  • company_name
    La empresa asociada al dominio.
  • 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.

Ejemplos de código

Posibles causas de error por estado desconocido

  • Causa
    Descripción
  • FREE_DOMAIN_ERROR
    No se puede encontrar el patrón para dominios gratuitos
  • DOMAIN_SYNTAX_ERROR
    Error de sintaxis de dominio
  • COMPANY_DOMAIN_ERROR
    Se debe ingresar el dominio o el nombre de la empresa
  • COMPANY_DOMAIN_NOT_FOUND
    No hay ningún dominio asignado para este nombre de empresa
  • UNEXPECTED_ERROR_OCCURRED_DURING_VALIDATION
    Se ha producido un error inesperado durante la validación
  • DOMAIN_DOES_NOT_ACCEPT_MAIL
    El dominio no acepta correo
  • NO_DATA_FOR_THIS_DOMAIN
    No hay datos para este dominio
  • NO_DATA_FOR_THIS_COMPANY
    No hay datos para esta empresa

Otros posibles mensajes de error


    {
      "Message": "Invalid API key or your account ran out of credits"
    }

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.

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.

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.