@zerobounce/zero-bounce-sdk 1.1.2 → 1.2.0

package/README.md

@@ -37,7 +37,7 @@ const zeroBounce = new ZeroBounceSDK();
 Initialize the sdk with your api key:
 
 ```javascript
-zeroBounce.init("<YOUR_API_KEY>");
+zeroBounce.init("<YOUR_API_KEY>", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
 ```
 
 NOTE: all the methods are asynchronous they have to be used with async / await or .then.catch
@@ -252,29 +252,66 @@ try {
   console.error(error);
 }
 ```
-- ##### Email finder - Test a variety of patterns and combinations in real time until it identifies a valid business email.
+
+- ####### Email finder - Test a variety of patterns and combinations in real time until it identifies a valid business email.
 
 ```javascript
 // Parameters
 // ----------
 // domain: String
 //     The email domain for which to find the email format. 
-// first_name: String or null (Optional)
+// company_name: String
+//     The company name for which to find the email format.
+// first_name: String
 //     The first name of the person whose email format is being searched.
 // middle_name: String or null (Optional)
 //     The middle name of the person whose email format is being searched.
 // last_name: String or null (Optional)
 //     The last name of the person whose email format is being searched.
 
-const payload = {
+const domainPayload = {
   domain: "<DOMAIN>",
   first_name: "<FIRST_NAME>",
   middle_name: "<MIDDLE_NAME>",
   last_name: "<LAST_NAME>"
 }
 
+const companyNamePayload = {
+  company_name: "<COMPANY_NAME>",
+  first_name: "<FIRST_NAME>",
+  middle_name: "<MIDDLE_NAME>",
+  last_name: "<LAST_NAME>"
+}
+
+try {
+  const domainResponse = await zeroBounce.findEmailByDomain(domainPayload);
+  const companyNameResponse = await zeroBounce.findEmailByCompanyName(companyNamePayload);
+} catch (error) {
+  console.error(error);
+}
+```
+
+- ####### Domain Search - Find the domain based on a given domain name or company name
+
+```javascript
+// Parameters
+// ----------
+// domain: String
+//     The domain name for which to find the email format. 
+// company_name: String
+//     The company name for which to find the email format.
+
+const domainPayload = {
+  domain: "<DOMAIN>"
+}
+
+const companyNamePayload = {
+  company_name: "<COMPANY_NAME>"
+}
+
 try {
-  const response = await zeroBounce.guessFormat(payload);
+  const domainResponse = await zeroBounce.findEmailFormatByDomain(domainPayload);
+  const companyNameResponse = await zeroBounce.findEmailFormatByCompanyName(companyNamePayload);
 } catch (error) {
   console.error(error);
 }

package/documentation.md

@@ -31,10 +31,10 @@ const ZeroBounceSDK = require('@zerobounce/zero-bounce-sdk')
 const zeroBounce = new ZeroBounceSDK();
 ```
 
-Initialize the sdk with your api key:
+Initialize the sdk with your api key and your preferred api:
 
 ```javascript
-zeroBounce.init("<YOUR_API_KEY>");
+zeroBounce.init("<YOUR_API_KEY>", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
 ```
 
 NOTE: all the methods are asynchronous they have to be used with async / await or .then.catch
@@ -257,22 +257,58 @@ try {
 // ----------
 // domain: String
 //     The email domain for which to find the email format. 
-// first_name: String or null (Optional)
+// company_name: String
+//     The company name for which to find the email format.
+// first_name: String
 //     The first name of the person whose email format is being searched.
 // middle_name: String or null (Optional)
 //     The middle name of the person whose email format is being searched.
 // last_name: String or null (Optional)
 //     The last name of the person whose email format is being searched.
 
-const payload = {
+const domainPayload = {
   domain: "<DOMAIN>",
   first_name: "<FIRST_NAME>",
   middle_name: "<MIDDLE_NAME>",
   last_name: "<LAST_NAME>"
 }
 
+const companyNamePayload = {
+  company_name: "<COMPANY_NAME>",
+  first_name: "<FIRST_NAME>",
+  middle_name: "<MIDDLE_NAME>",
+  last_name: "<LAST_NAME>"
+}
+
+try {
+  const domainResponse = await zeroBounce.findEmailByDomain(domainPayload);
+  const companyNameResponse = await zeroBounce.findEmailByCompanyName(companyNamePayload);
+} catch (error) {
+  console.error(error);
+}
+```
+
+- ####### Domain Search - Find the domain based on a given domain name or company name
+
+```javascript
+// Parameters
+// ----------
+// domain: String
+//     The domain name for which to find the email format. 
+// company_name: String
+//     The company name for which to find the email format.
+
+const domainPayload = {
+  domain: "<DOMAIN>"
+}
+
+const companyNamePayload = {
+  company_name: "<COMPANY_NAME>"
+}
+
 try {
-  const response = await zeroBounce.guessFormat(payload);
+  const domainResponse = await zeroBounce.findEmailFormatByDomain(domainPayload);
+  const companyNameResponse = await zeroBounce.findEmailFormatByCompanyName(companyNamePayload);
 } catch (error) {
   console.error(error);
 }

package/documentation_es.md

@@ -31,10 +31,10 @@ const ZeroBounceSDK = require('zero-bounce-sdk')
 const zeroBounce = new ZeroBounceSDK();
 ```
 
-Inicialice el SDK con su clave de API:
+Inicialice el SDK con su clave de API y tu API preferida:
 
 ```javascript
-zeroBounce.init("<SU_CLAVE_DE_API>");
+zeroBounce.init("<SU_CLAVE_DE_API>", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
 ```
 
 NOTA: todos los métodos son asíncronos y deben usarse con async / await o .then.catch.
@@ -254,6 +254,71 @@ try {
 }
 ```
 
+- ####### Buscador de correos electrónicos: prueba una variedad de patrones y combinaciones en tiempo real hasta que identifique un correo electrónico comercial válido.
+
+```javascript
+// Parameters
+// ----------
+// domain: String
+//     El dominio de correo electrónico para el que se debe buscar el formato de correo electrónico. 
+// company_name: String
+//     El nombre de la empresa para la que se busca el formato de correo electrónico.
+// first_name: String
+//     El nombre de la persona cuyo formato de correo electrónico se está buscando.
+// middle_name: String or null (Optional)
+//     El segundo nombre de la persona cuyo formato de correo electrónico se está buscando.
+// last_name: String or null (Optional)
+//     El apellido de la persona cuyo formato de correo electrónico se está buscando.
+
+const domainPayload = {
+  domain: "<DOMAIN>",
+  first_name: "<FIRST_NAME>",
+  middle_name: "<MIDDLE_NAME>",
+  last_name: "<LAST_NAME>"
+}
+
+const companyNamePayload = {
+  company_name: "<COMPANY_NAME>",
+  first_name: "<FIRST_NAME>",
+  middle_name: "<MIDDLE_NAME>",
+  last_name: "<LAST_NAME>"
+}
+
+try {
+  const domainResponse = await zeroBounce.findEmailByDomain(domainPayload);
+  const companyNameResponse = await zeroBounce.findEmailByCompanyName(companyNamePayload);
+} catch (error) {
+  console.error(error);
+}
+```
+
+- ####### Búsqueda de dominios: encuentre el dominio basado en un nombre de dominio o nombre de empresa determinados.
+
+```javascript
+// Parameters
+// ----------
+// domain: String
+//     El nombre de dominio para el que se busca el formato de correo electrónico. 
+// company_name: String
+//     El nombre de la empresa para la que se debe buscar el formato de correo electrónico.
+
+const domainPayload = {
+  domain: "<DOMAIN>"
+}
+
+const companyNamePayload = {
+  company_name: "<COMPANY_NAME>"
+}
+
+try {
+  const domainResponse = await zeroBounce.findEmailFormatByDomain(domainPayload);
+  const companyNameResponse = await zeroBounce.findEmailFormatByCompanyName(companyNamePayload);
+} catch (error) {
+  console.error(error);
+}
+```
+
+
 **Puede utilizar cualquiera de las siguientes direcciones de correo electrónico para probar la API, no se cobran créditos por estas direcciones de correo electrónico de prueba:**
 
 - disposable@example.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerobounce/zero-bounce-sdk",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "This SDK contains methods for interacting easily with ZeroBounce API. More information about ZeroBounce you can find in the official documentation.",
   "main": "dist/zeroBounceSDK.js",
   "scripts": {

package/src/utils.js

@@ -1,5 +1,4 @@
 // Constants
-export const API_BASE_URL = "https://api.zerobounce.net/v2";
 export const API_BULK_BASE_URL = "https://bulkapi.zerobounce.net/v2";
 export const HEADERS = {
   Accept: "*/*",
@@ -15,9 +14,10 @@ export async function createRequest({
   batch = false,
   returnText = false,
   scoring = false,
+  apiBaseURL
 }) {
   const url = `${
-    batch ? API_BULK_BASE_URL : API_BASE_URL
+    batch ? API_BULK_BASE_URL : apiBaseURL
   }${path}?${new URLSearchParams(params)}`;
 
   try {

package/src/zero-bounce.js

@@ -1,19 +1,28 @@
 import { createRequest, notInitialized, parameterIsMissing } from "./utils.js";
 
 export class ZeroBounceSDK {
+  static ApiURL = Object.freeze({
+    DEFAULT_API_URL: "https://api.zerobounce.net/v2",
+    USA_API_URL: "https://api-us.zerobounce.net/v2",
+    EU_API_URL: "https://api-eu.zerobounce.net/v2"
+  });
+
   constructor() {
     this._initialized = false;
     this._api_key = null;
+    this._api_base_url = ZeroBounceSDK.ApiURL.DEFAULT_API_URL;
   }
 
   /**
    * @param apiKey - your private API key
+   * @param apiBaseURL - your preferred API, possible values being ApiURL.DEFAULT_API_URL, ApiURL.USAAPIURL, ApiURL.EUAPIURL
    * */
-  init(apiKey) {
+  init(apiKey, apiBaseURL = ZeroBounceSDK.ApiURL.DEFAULT_API_URL) {
     if (!apiKey) {
       parameterIsMissing("Api key", "Please provide a valid API key.");
     } else {
       this._api_key = apiKey;
+      this._api_base_url = apiBaseURL;
       this._initialized = true;
     }
   }
@@ -26,7 +35,7 @@ export class ZeroBounceSDK {
     const params = {
       api_key: this._api_key,
     };
-    return createRequest({ requestType: "GET", params, path: "/getcredits" });
+    return createRequest({ requestType: "GET", params, path: "/getcredits", apiBaseURL: this._api_base_url });
   }
 
   /**
@@ -46,7 +55,7 @@ export class ZeroBounceSDK {
       email: email,
       ip_address,
     };
-    return createRequest({ requestType: "GET", params, path: "/validate" });
+    return createRequest({ requestType: "GET", params, path: "/validate", apiBaseURL: this._api_base_url });
   }
 
   /**
@@ -73,7 +82,8 @@ export class ZeroBounceSDK {
     return createRequest({
       requestType: "GET",
       params,
-      path: "/getapiusage",
+      path: "/getapiusage", 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -98,7 +108,8 @@ export class ZeroBounceSDK {
       requestType: "POST",
       path: "/validatebatch",
       body: JSON.stringify(body),
-      batch: true,
+      batch: true, 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -120,7 +131,8 @@ export class ZeroBounceSDK {
     return createRequest({
       requestType: "GET",
       params,
-      path: "/activity",
+      path: "/activity", 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -184,7 +196,8 @@ export class ZeroBounceSDK {
       requestType: "POST",
       path: "/sendfile",
       body,
-      batch: true,
+      batch: true, 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -229,7 +242,8 @@ export class ZeroBounceSDK {
       requestType: "POST",
       path: "/scoring/sendfile",
       body,
-      batch: true,
+      batch: true, 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -251,6 +265,7 @@ export class ZeroBounceSDK {
       params,
       path,
       batch: true,
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -286,7 +301,8 @@ export class ZeroBounceSDK {
       path,
       batch: true,
       returnText: true,
-      scoring,
+      scoring, 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -321,7 +337,8 @@ export class ZeroBounceSDK {
       params,
       path,
       batch: true,
-      scoring,
+      scoring, 
+      apiBaseURL: this._api_base_url
     });
   }
 
@@ -342,6 +359,144 @@ export class ZeroBounceSDK {
   // EMAIL FINDER
 
   /**
+   * @param domain str - domain of the email address
+   * @param first_name str - first name
+   * @param middle_name str or null - middle name
+   * @param last_name str or null - last name
+   * */
+  findEmailByDomain({
+    domain, 
+    first_name, 
+    middle_name = null, 
+    last_name = null
+  }) {
+    return this._findEmail({
+      domain: domain,
+      first_name: first_name,
+      middle_name: middle_name,
+      last_name: last_name
+    });
+  }
+
+  /**
+   * @param company_name str - company name of the email address
+   * @param first_name str - first name
+   * @param middle_name str or null - middle name
+   * @param last_name str or null - last name
+   * */
+  findEmailByCompanyName({
+    company_name, 
+    first_name, 
+    middle_name = null, 
+    last_name = null
+  }) {
+    return this._findEmail({
+      company_name: company_name,
+      first_name: first_name,
+      middle_name: middle_name,
+      last_name: last_name
+    });
+  }
+
+  _findEmail({
+    domain = null,
+    company_name = null,
+    first_name,
+    middle_name = null,
+    last_name = null
+  }) {
+    if (!this._initialized) {
+      notInitialized();
+      return;
+    } else if (!domain && !company_name) {
+      parameterIsMissing("domain");
+      parameterIsMissing("company_name");
+      return;
+    } else if (!first_name) {
+      parameterIsMissing("first_name");
+      return;
+    }
+
+    const params = {
+      api_key: this._api_key,
+      first_name: first_name,
+      middle_name: middle_name,
+      last_name: last_name,
+    };
+
+    if (domain != null) {
+      params["domain"] = domain;
+    } else if (company_name != null) {
+      params["company_name"] = company_name;
+    }
+
+    return createRequest({
+      requestType: "GET",
+      params,
+      path: "/guessformat", 
+      apiBaseURL: this._api_base_url
+    });
+  }
+
+
+  // DOMAIN SEARCH
+
+  /**
+   * @param domain str - domain name
+   * */
+  findEmailFormatByDomain({
+    domain
+  }) {
+    return this._findEmailFormat({
+      domain: domain
+    });
+  }
+
+  /**
+   * @param company_name str - company name
+   * */
+  findEmailFormatByCompanyName({
+    company_name
+  }) {
+    return this._findEmailFormat({
+      company_name: company_name
+    });
+  }
+
+  _findEmailFormat({
+    domain = null,
+    company_name = null
+  }) {
+    if (!this._initialized) {
+      notInitialized();
+      return;
+    } else if (!domain && !company_name) {
+      parameterIsMissing("domain");
+      parameterIsMissing("company_name");
+      return;
+    }
+
+    const params = {
+      api_key: this._api_key
+    };
+
+    if (domain != null) {
+      params["domain"] = domain;
+    } else if (company_name != null) {
+      params["company_name"] = company_name;
+    }
+
+    return createRequest({
+      requestType: "GET",
+      params,
+      path: "/guessformat", 
+      apiBaseURL: this._api_base_url
+    });
+  }
+
+
+  /**
+   * @deprecated Use findEmail for Email Finder API, or findEmailFormat for Domain Search API.
    * @param domain str - domain of the email address
    * @param first_name str or null - first name
    * @param middle_name str or null - middle name
@@ -353,6 +508,7 @@ export class ZeroBounceSDK {
     middle_name = null, 
     last_name = null
   }) {
+    console.warn("guessFormat() is deprecated. Use findEmail for Email Finder API, or findEmailFormat for Domain Search API.");
     if (!this._initialized) {
       notInitialized();
       return;
@@ -372,7 +528,8 @@ export class ZeroBounceSDK {
     return createRequest({
       requestType: "GET",
       params,
-      path: "/guessformat",
+      path: "/guessformat", 
+      apiBaseURL: this._api_base_url
     });
   }
 }

package/tests/zero-bounce.test.js

@@ -31,7 +31,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getCredits();
       } catch (error) {
@@ -49,7 +49,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getCredits();
       expect(response).toEqual(expectedResponse);
     });
@@ -66,7 +66,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if stardDate is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getApiUsage(null, endDate);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -74,7 +74,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if endDate is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getApiUsage(startDate, null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -82,7 +82,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getApiUsage(startDate, endDate);
       } catch (error) {
@@ -120,6 +120,7 @@ describe("ZeroBounceSDK", () => {
         "sub_status_mailbox_quota_exceeded": 0,
         "sub_status_forcible_disconnect": 0,
         "sub_status_failed_smtp_connection": 0,
+        "sub_status_accept_all": 0,
         "sub_status_mx_forward": 0,
         "sub_status_alternate": 0,
         "sub_status_blocked": 0,
@@ -133,7 +134,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getApiUsage(startDate, endDate);
       expect(response).toEqual(expectedResponse);
     });
@@ -150,7 +151,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if email is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.validateEmail(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -158,7 +159,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.validateEmail(email, ip_address);
       } catch (error) {
@@ -194,7 +195,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.validateEmail(email, ip_address);
       expect(response).toEqual(expectedResponse);
     });
@@ -213,7 +214,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if email list is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.validateBatch(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -221,7 +222,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.validateBatch(emailBatch);
       } catch (error) {
@@ -283,7 +284,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.validateBatch(emailBatch);
       expect(response).toEqual(expectedResponse);
     });
@@ -299,7 +300,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if email is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getEmailActivity(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -307,7 +308,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getEmailActivity(email);
       } catch (error) {
@@ -326,7 +327,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getEmailActivity(email);
       expect(response).toEqual(expectedResponse);
     });
@@ -352,7 +353,7 @@ describe("ZeroBounceSDK", () => {
         email_address_column: 1,
       };
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.sendFile(payload);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -364,7 +365,7 @@ describe("ZeroBounceSDK", () => {
         file: file,
       };
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.sendFile(payload);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -372,7 +373,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.sendFile(payload);
       expect(response).toEqual({
         "success": "False",
@@ -395,7 +396,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.sendFile(payload);
       expect(response).toEqual(expectedResponse);
     });
@@ -421,7 +422,7 @@ describe("ZeroBounceSDK", () => {
         email_address_column: 1,
       };
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.sendScoringFile(payload);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -433,7 +434,7 @@ describe("ZeroBounceSDK", () => {
         file: file,
       };
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.sendScoringFile(payload);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -441,7 +442,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.sendScoringFile(payload);
       expect(response).toEqual({
         "success": "False",
@@ -464,7 +465,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.sendScoringFile(payload);
       expect(response).toEqual(expectedResponse);
     });
@@ -480,7 +481,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if file id is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getFileStatus(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -488,7 +489,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getFileStatus(fileId);
       } catch (error) {
@@ -513,7 +514,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getFileStatus(fileId);
       expect(response).toEqual(expectedResponse);
     });
@@ -529,7 +530,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if file id is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getScoringFileStatus(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -537,7 +538,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getScoringFileStatus(fileId);
       } catch (error) {
@@ -561,7 +562,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getScoringFileStatus(fileId);
       expect(response).toEqual(expectedResponse);
     });
@@ -577,7 +578,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if file id is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getFile(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -585,7 +586,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getFile(fileId);
       } catch (error) {
@@ -600,7 +601,7 @@ describe("ZeroBounceSDK", () => {
         return Promise.resolve(expectedResponse);
       });
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getFile(fileId);
       expect(createRequestSpy.mock.calls[0][0]["returnText"]).toEqual(true);
       expect(response).toEqual(expectedResponse);
@@ -617,7 +618,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if file id is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.getScoringFile(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -625,7 +626,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.getScoringFile(fileId);
       } catch (error) {
@@ -640,7 +641,7 @@ describe("ZeroBounceSDK", () => {
         return Promise.resolve(expectedResponse);
       });
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.getScoringFile(fileId);
       expect(createRequestSpy.mock.calls[0][0]["returnText"]).toEqual(true);
       expect(response).toEqual(expectedResponse);
@@ -657,7 +658,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if file id is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.deleteFile(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -665,7 +666,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.deleteFile(fileId);
       } catch (error) {
@@ -686,7 +687,7 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.deleteFile(fileId);
       expect(response).toEqual(expectedResponse);
     });
@@ -702,7 +703,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should throw an error if file id is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       await zeroBounceSDK.deleteScoringFile(null);
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
@@ -710,7 +711,7 @@ describe("ZeroBounceSDK", () => {
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
         await zeroBounceSDK.deleteScoringFile(fileId);
       } catch (error) {
@@ -731,14 +732,14 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       const response = await zeroBounceSDK.deleteScoringFile(fileId);
       expect(response).toEqual(expectedResponse);
     });
   });
 
   // EMAIL FINDER
-  describe("guessFormat", () => {
+  describe("findEmail", () => {
     const payload = {
       domain: "example.com",
       first_name: "John",
@@ -746,22 +747,22 @@ describe("ZeroBounceSDK", () => {
     }
 
     it("should throw an error if not initialized", async () => {
-      await zeroBounceSDK.guessFormat(payload);
+      await zeroBounceSDK.findEmailByDomain(payload);
       expect(console.error).toHaveBeenCalledWith(initErrorMessage);
     });
 
     it("should throw an error if domain is missing", async () => {
-      zeroBounceSDK.init("valid-api-key");
-      await zeroBounceSDK.guessFormat({domain: null});
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
+      await zeroBounceSDK.findEmailByDomain({domain: null});
       expect(console.error).toHaveBeenCalledWith(
         expect.stringContaining(missingParamMessage)
       );
     });
 
     it("should return error response with invalid API key", async () => {
-      zeroBounceSDK.init("invalid-api-key");
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
       try {
-        await zeroBounceSDK.guessFormat(payload);
+        await zeroBounceSDK.findEmailByDomain(payload);
       } catch (error) {
         expect(error.message).toEqual('TypeError: Network request failed');
       }
@@ -770,10 +771,59 @@ describe("ZeroBounceSDK", () => {
     it("should return the validated format data", async () => {
       const expectedResponse = {
         "email": "john.doe@example.com",
+        "email_confidence": "high",
         "domain": "",
+        "company_name": "",
+        "did_you_mean": "",
+        "failure_reason": ""
+      }
+
+      jest.spyOn(global, "fetch").mockImplementationOnce(() => Promise.resolve({
+        json: () => Promise.resolve(expectedResponse),
+        text: () => Promise.resolve(JSON.stringify(expectedResponse)),
+      }));
+
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
+      const response = await zeroBounceSDK.findEmailByDomain(payload);
+      expect(response).toEqual(expectedResponse);
+    });
+  });
+
+  // DOMAIN SEARCH
+  describe("findEmailFormat", () => {
+    const payload = {
+      domain: "example.com",
+      first_name: "John",
+      last_name: "Doe",
+    }
+
+    it("should throw an error if not initialized", async () => {
+      await zeroBounceSDK.findEmailFormatByDomain(payload);
+      expect(console.error).toHaveBeenCalledWith(initErrorMessage);
+    });
+
+    it("should throw an error if domain is missing", async () => {
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
+      await zeroBounceSDK.findEmailFormatByDomain({domain: null});
+      expect(console.error).toHaveBeenCalledWith(
+        expect.stringContaining(missingParamMessage)
+      );
+    });
+
+    it("should return error response with invalid API key", async () => {
+      zeroBounceSDK.init("invalid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
+      try {
+        await zeroBounceSDK.findEmailFormatByDomain(payload);
+      } catch (error) {
+        expect(error.message).toEqual('TypeError: Network request failed');
+      }
+    });
+
+    it("should return the validated format data", async () => {
+      const expectedResponse = {
+        "domain": "",
+        "company_name": "",
         "format": "first.last",
-        "status": "valid",
-        "sub_status": "",
         "confidence": "high",
         "did_you_mean": "",
         "failure_reason": "",
@@ -785,8 +835,8 @@ describe("ZeroBounceSDK", () => {
         text: () => Promise.resolve(JSON.stringify(expectedResponse)),
       }));
 
-      zeroBounceSDK.init("valid-api-key");
-      const response = await zeroBounceSDK.guessFormat(payload);
+      zeroBounceSDK.init("valid-api-key", ZeroBounceSDK.ApiURL.DEFAULT_API_URL);
+      const response = await zeroBounceSDK.findEmailFormatByDomain(payload);
       expect(response).toEqual(expectedResponse);
     });
   });