API de búsqueda de dominio (V2)
Documentación de la API de búsqueda masiva de dominios
Búsqueda de dominio - Enviar archivo
La API domain-search/sendfile le permite enviar un archivo para la búsqueda de dominios masiva. Esta guía le brindará todo lo que necesita saber sobre cómo encontrar dominios de forma masiva a través de la API.
No existen restricciones respecto del tamaño del archivo, de la cantidad de correos electrónicos ni de la cantidad de archivos que usted puede enviar por medio de este punto de enlace.
Cada búsqueda consumirá 20 créditos si se arroja un formato de correo electrónico válido. Si usted 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. Siempre que tenga las consultas disponibles a través de la suscripción o los créditos en su cuenta para cubrir la cantidad de búsquedas enviadas en el archivo, se aceptará su archivo.
Para evitar interrupciones de la API, considere activar el pago automático en los ajustes de su cuenta de ZeroBounce para asegurarse de que nunca se agoten los créditos.
POST /DOMAIN-SEARCH/SENDFILE
API URL: https://bulkapi.zerobounce.net/domain-search/sendfile
El tipo de contenido del cuerpo debe ser multipart/form-data.
Parámetros del enlace
- ParameterDescription
- fileEl archivo csv o txt. Contenido de la matriz de bytes para el archivo enviado. El encabezado del contenido es del tipo "texto/csv"
- api_keySu clave API, que se encuentra en su cuenta. (Requerida)
- domain_columnEl índice de columna del dominio en el archivo. El índice comienza a partir de 1 (obligatorio).
- has_header_rowSi la primera fila del archivo enviado es una fila de encabezado; verdadero o falso (opcional)
RESPUESTA DEL PUNTO FINAL
Respuesta exitosa
Respuesta de error
¿Necesita ayuda para enviar su archivo para la búsqueda de dominios masiva? Díganos lo que necesita: nuestro equipo está disponible en todo momento para asistirlo.
Búsqueda de dominio - Estado de archivo
La API filestatus de la búsqueda de dominio arroja el estado de procesamiento del archivo para el archivo que se ha enviado utilizando la API sendfile de la búsqueda de dominios.
GET /DOMAIN-SEARCH/FILESTATUS
API URL: https://bulkapi.zerobounce.net/domain-search/filestatus
Parámetros del enlace
- ParameterDescription
- api_keySu clave API, que se encuentra en su cuenta. (Requerida)
- file_idEl ID de archivo devuelto al llamar a la API de enviararchivo.
Si desea llamar a la API desde su navegador para probarla, reemplace el parámetro API KEY con su clave de API exclusiva (que se encuentra en
https://bulkapi.zerobounce.net/domain-search/filestatus?api_key=[reemplazarconlasuya]&file_id=[reemplazarconlasuya]
RESPUESTA DEL PUNTO FINAL
Respuesta exitosa
Respuesta de error
Por cada dominio 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, la búsqueda de dominio 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 de búsqueda de dominio? 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.
Búsqueda de dominio - Obtener archivo
La API getfile de la búsqueda de dominio le permite obtener los resultados para el archivo que envío a través de la API sendfile de la búsqueda de dominio.
GET /DOMAIN-SEARCH/GETFILE
API URL: https://bulkapi.zerobounce.net/domain-search/getfile
Parámetros del enlace
- ParameterDescription
- api_keySu clave API, que se encuentra en su cuenta. (Requerida)
- file_idEl ID de archivo devuelto al llamar a la API de enviararchivo.
Si desea llamar a la API desde su navegador para probarla, todo lo que debe hacer es reemplazar el parámetro API KEY con su clave de API (que se encuentra en ajustes de cuenta de ZeroBounce ) y el parámetro FILE ID con el ID de archivo que devuelve la API sendfile:
https://bulkapi.zerobounce.net/email-finder/getfile?api_key=reemplazarconlasuya&file_id=[reemplazarconlasuya]
RESPUESTA DEL PUNTO FINAL
Respuesta exitosa
La API getfile de la búsqueda de dominio arroja el archivo de resultados de la búsqueda de dominio. 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 de la búsqueda de dominio? 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.
Búsqueda de dominio - Borrar archivo
La API deletefile de la búsqueda de dominio le permite borrar el archivo que ha enviado usando la API sendfile de la búsqueda de dominio. Tenga en cuenta que el archivo puede borrarse únicamente cuando el estado es Complete (Completo).
GET /DOMAIN-SEARCH/DELETEFILE
API URL: https://bulkapi.zerobounce$.net/domain-search/deletefile
Parámetros del enlace
- ParameterDescription
- api_keySu clave API, que se encuentra en su cuenta. (Requerida)
- file_idEl ID de archivo devuelto al llamar a la API de enviararchivo.
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 el archivo de la API de la búsqueda de dominio, 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.