🚀 ValidatorMails - Bulk Email Finder & Verifier Actor

ValidatorMails is a high-performance, enterprise-grade email validation and discovery SaaS platform. This official Apify Actor enables you to process bulk leads list for Email Verification or Email Discovery asynchronously in the cloud, syncing results directly to your Apify datasets.

---

🌟 Key Features

• 🔍 Smart Lead Discovery: Generates 28 naming patterns (e.g. first.last@domain, f.last@domain) and prioritizes them using the Master Leads Vault history to save credits.
• 🛡️ Enterprise Catch-All Guessing:
  • Automatically detects Office 365 mailboxes and runs live directory handshake validation (100% accurate results).
  • Guesses naming conventions for standard catch-all domains using database analytics.
  • Skips checking known invalid patterns to keep domain reputation high.
• ⚡ Async Concurrency Throttling: Configure parallel workers (1 to 20) to query endpoints at optimal speeds.
• 📋 Non-Blocking UI Sync: Works seamlessly with ValidatorMails backend architecture.
• suppressed Suppressions: Automatically detects opt-outs (GDPR/CCPA compliant) and prevents re-verification.

---

📥 Actor Inputs Configuration

This actor provides a clean, grouped console user interface on the Apify platform:

⚙️ API Configuration & Authentication

• Operation Mode: Select Find Emails or Verify Emails.
• API Key: Your private ValidatorMails API token (sk_live_...).
• Base API URL: Endpoint of your FastAPI server (default: https://validatormails.com).

📥 Input Leads Data

• Leads Input List: One entry per line.
  • Finder Mode: Full Name, domain.com (e.g., Sadique Shaikh, theinsightsview.com)
  • Verifier Mode: email@domain.com

🚀 Performance Settings

• Concurrency Limit: Limit of parallel API calls (defaults to 5 to protect server stability).

---

📤 Dataset Output Fields

Every successfully processed row generates detailed metrics in your Apify Dataset:

{
  "Email": "sadique@theinsightsview.com",
  "Status": "Valid",
  "Reason": "Valid",
  "Time": "0.00s (Cached)",
  "CatchAll": "No",
  "Disposable": false,
  "Role": false,
  "FreeEmail": false,
  "MXRecord": "mx1.hostinger.com",
  "Error": null
}

---

🚀 How to Run Locally

If you want to run this actor on your local machine using the Apify SDK:

1. Clone or download this project.
2. Initialize virtual environment:

   python -m venv venv
   .\venv\Scripts\activate
   pip install -r requirements.txt
   

3. Create your input configuration inside storage/key_value_stores/default/INPUT.json.
4. Execute:

   $python -m src
   

---

🌍 Deploying to Apify Cloud

Deploy in one command to your developer account:

apify login -t <YOUR_API_TOKEN>
apify push

Your Actor will instantly build and be ready to run under Development > My Actors!