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ámetroObligatorioDescripción
- api_keySíTu clave API, disponible en tu cuenta.
- domainSíEl dominio de correo electrónico para el cual se busca el formato del correo.
- company_nameSíEl nombre de la empresa para la cual se busca el formato del correo electrónico.
- first_nameNoEl nombre de la persona cuyo formato de correo electrónico se está buscando. [opcional]
- middle_nameNoEl segundo nombre de la persona cuyo formato de correo electrónico se está buscando. [opcional]
- last_nameNoEl 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
- PropiedadesDescripción
- emailLa dirección de correo electrónico resultante identificada por la API.
- email_confidenceEl nivel de confianza que tenemos en que el correo electrónico existe. Valores posibles: ALTO, MEDIO, BAJO.
- domainEl nombre de dominio proporcionado.
- company_nameLa empresa asociada con el dominio.
- did_you_meanPor ejemplo, una sugerencia en caso de que un nombre se use en el campo de apellido.
- failure_reasonUn 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
- PropiedadesDescripción
- FREE_DOMAIN_ERRORNo se puede encontrar un patrón para dominios gratuitos.
- DOMAIN_SYNTAX_ERRORError de sintaxis del dominio.
- COMPANY_DOMAIN_ERRORDebe introducirse el dominio o el nombre de la empresa.
- COMPANY_DOMAIN_NOT_FOUNDNo hay un dominio asignado para este nombre de empresa.
- UNEXPECTED_ERROR_OCCURRED_DURING_VALIDATIONOcurrió un error inesperado durante la validación.
- DOMAIN_DOES_NOT_ACCEPT_MAILEl dominio no acepta correos electrónicos.
- NO_DATA_FOR_THIS_DOMAINNo hay datos para este dominio.
- NO_DATA_FOR_THIS_COMPANYNo 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.
Documentación de la API del buscador de correo electrónicoⓘ masivo
Buscador de correo electrónicoⓘ - Enviar archivo
The email-finder/sendfile API allows you to send a file for bulk email finder. This guide will provide everything you need to know on how to find email addresses in bulk via API.
There is no restriction on the file size, number of emails, or number of files you can submit using this endpoint.
Each search will consume 20 credits if a valid email format is returned. If you are a monthly subscriber, the API call will consume 1 Email Finder query if a valid format is returned. As long as you have the available queries via subscription or the credits in your account to cover the number of searches submitted in the file, your file will be accepted.
To avoid API interruptions, consider activating AutoPay in your ZeroBounce account settings to ensure you never run out of credits.
POST /EMAIL-FINDER/SENDFILE
API URL: https://bulkapi.zerobounce.net/email-finder/sendfile
The content type of the body should be multipart/form-data.
Parámetros del enlace
- ParámetroDescripción
- fileEl archivo CSV o TXT. Contenido en matriz de bytes del archivo enviado. El encabezado de contenido es de tipo "text/csv".
- api_keySu clave API, que se encuentra en su cuenta. (Obligatorio)
- domain_columnEl índice de la columna de dominio en el archivo. El índice comienza en 1 (obligatorio).
- first_name_columnEl índice de columna para el nombre. (Es obligatorio que una de las columnas, ya sea el nombre o la columna de nombre completo, esté completada)
- last_name_columnEl índice de columna para el apellido. (Opcional)
- middle_name_columnEl índice de columna para el segundo nombre. (Opcional)
- full_name_columnEl índice de columna para el nombre completo. (Es obligatorio que una de las columnas, ya sea el nombre o la columna de nombre completo, esté completada)
- has_header_rowIndica si la primera fila del archivo enviado es una fila de encabezado; true o false (opcional)
RESPUESTA DEL PUNTO FINAL
Respuesta exitosa
Respuesta de error
¿Necesita ayuda para enviar su archivo al motor de búsqueda de correo masivo? Indíquenos lo que necesita: nuestro equipo está disponible en todo momento para asistirle.
Buscador de correo electrónicoⓘ - Estado del archivo archivado
La API filestatus del buscador de correo electrónicoⓘ devuelve el estado de procesamiento del archivo que se envió mediante la API sendfile del buscador de correo electrónicoⓘ.
GET /EMAIL-FINDER/FILESTATUS
API URL: https://bulkapi.zerobounce.net/email-finder/filestatus
Parámetros del enlace
- ParámetroDescripción
- api_keySu clave API, que se encuentra en su cuenta. (Obligatorio)
- file_idEl ID de archivo devuelto al llamar a la API sendfile.
If you want to call the API from your browser to test it, replace the API KEY parameter with your unique API key (found in your ZeroBounce account settings) and the FILE ID parameter with the returned file ID from sendfile API:
RESPUESTA DEL PUNTO FINAL
Respuesta exitosa
Respuesta de error
Para cada dirección de correo electrónico que verifica, la API del buscador de correo electrónicoⓘ consume 1 consulta (si tiene una suscripción activa del kit de herramientas para la entrega de correo electrónico). Si tiene créditos u opta por la opción de pagar al usar, el buscador de correo electrónicoⓘ consumirá 20 créditos por cada resultado exitoso. Si utiliza la API con regularidad, tome medidas para asegurarse de reponer los créditos de su cuenta periódicamente para evitar interrupciones.
¿Necesita ayuda para determinar el estado de los archivos de la API del buscador de correo electrónicoⓘ? Comuníquese con nuestro equipo de atención al cliente. Estamos a su disposición en todo momento para responder cualquier pregunta que tenga y asistirlo.
Buscador de correo electrónicoⓘ - Obtener archivo
La API getfile del buscador de correo electrónicoⓘ le permite obtener los resultados del buscador de correo electrónicoⓘ para el archivo que envió por medio de la API sendfile del buscador de correo electrónicoⓘ.
GET /EMAIL-FINDER/GETFILE
API URL: https://bulkapi.zerobounce.net/email-finder/getfile
Parámetros del enlace
- ParámetroDescripción
- api_keySu clave API, que se encuentra en su cuenta. (Obligatorio)
- file_idEl ID de archivo devuelto al llamar a la API sendfile.
If you want to call the API from your browser to test it, all you have to do is to replace the API KEY parameter with your API key (found in your ZeroBounce account settings ) and the FILE ID with the returned file ID from sendfile API:
RESPUESTA DEL PUNTO FINAL
Respuesta exitosa
La API getfile del buscador de correo electrónicoⓘ devuelve el archivo de resultados del buscador de correo electrónicoⓘ. El tipo de contenido devuelto es "application/octet-stream". Usted puede obtener el nombre de archivo desde: response.Content.Headers.ContentDisposition.FileName. Si está llamando a la API directamente desde el navegador, puede guardar o abrir el archivo de resultados desde el navegador.
Respuesta de error
¿Necesita ayuda para obtener los resultados de la API del buscador de correo electrónicoⓘ? Nuestro equipo está disponible para ayudarlo. Comuníquese con nosotros en cualquier momento. Ofrecemos atención al cliente las 24 horas del día, los 7 días de la semana.
Buscador de correo electrónicoⓘ - Borrar archivo
La API deletefile del buscador de correo electrónicoⓘ le permite borrar el archivo que ha enviado usando la API sendfile del buscador de correo electrónicoⓘ. Tenga en cuenta que el archivo puede borrarse únicamente cuando el estado es Complete (Completo).
GET /EMAIL-FINDER/GETFILE
API URL: https://bulkapi.zerobounce.net/email-finder/deletefile
Parámetros del enlace
- ParámetroDescripción
- api_keySu clave API, que se encuentra en su cuenta. (Obligatorio)
- file_idEl ID de archivo devuelto al llamar a la API sendfile.
RESPUESTA DEL PUNTO FINAL
A continuación, puede encontrar ejemplos de respuestas exitosas y con errores.
Respuesta exitosa
Respuesta de error
Si necesita ayuda para borrar su archivo API del buscador de correo electrónicoⓘ, comuníquese con nosotros. Nuestro equipo está a su disposición las 24 horas del día, los 7 días de la semana para responder cualquier consulta y simplificar su trabajo.