PANEL DE API (V2)

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

URL de API de EU: https://api-eu.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í
Tu clave API, disponible en tu cuenta.
domain
Sí
El dominio de correo electrónico para el cual se busca el formato del correo.
company_name
Sí
El nombre de la empresa para la cual se busca el formato del correo electrónico.
first_name
No
El nombre de la persona cuyo formato de correo electrónico se está buscando. [opcional]
middle_name
No
El segundo nombre de la persona cuyo formato de correo electrónico se está buscando. [opcional]
last_name
No
El apellido de la persona cuyo formato de correo electrónico se está buscando. [opcional]

Nota: Debe ingresarse el “dominio” o el “nombre de la empresa”.

Respuesta exitosa

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 en que el correo electrónico existe. Valores posibles: ALTO, MEDIO, BAJO.
domain
El nombre de dominio proporcionado.
company_name
La empresa asociada con el dominio.
did_you_mean
Por ejemplo, una sugerencia en caso de que un nombre se use en el campo de apellido.
failure_reason
Un motivo para el resultado desconocido. Los valores posibles se pueden encontrar en la sección "Posibles razones del estado desconocido" a continuación.

Posibles causas de error por estado desconocido

Propiedades
Descripción

FREE_DOMAIN_ERROR
No se puede encontrar un patrón para dominios gratuitos.
DOMAIN_SYNTAX_ERROR
Error de sintaxis del dominio.
COMPANY_DOMAIN_ERROR
Debe introducirse el dominio o el nombre de la empresa.
COMPANY_DOMAIN_NOT_FOUND
No hay un dominio asignado para este nombre de empresa.
UNEXPECTED_ERROR_OCCURRED_DURING_VALIDATION
Ocurrió un error inesperado durante la validación.
DOMAIN_DOES_NOT_ACCEPT_MAIL
El dominio no acepta correos electrónicos.
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

Puede resolver este error asegurándose de que haya al menos una (1) consulta por suscripción o 20 créditos de ZeroBounce en el saldo de su cuenta antes de realizar la siguiente llamada a la API. Además, verifique que la clave API sea válida.

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.