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.