# Bulk Email Finder and Bulk Email Verifier (`thecfmarketing/validatormails-actor`) Actor

Verify bulk emails & find B2B leads with 99% accuracy. Features live SMTP checks, Microsoft O365 directory handshake, and catch-all pattern guessing to reduce bounce rates. Perfect for cold email outreach. Save credits with vault caching!

- **URL**: https://apify.com/thecfmarketing/validatormails-actor.md
- **Developed by:** [sadique shaikh](https://apify.com/thecfmarketing) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 1 total users, 0 monthly users, 94.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 email verifieds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🚀 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 lists for **Email Verification** or **Email Discovery** asynchronously in the cloud, syncing results directly to your Apify datasets.

***

### 🌟 Why Use ValidatorMails?

- **99% SMTP Verification Accuracy**: Real-time SMTP handshakes to ensure emails exist.
- **Catch-All Email Guessing**: Smart algorithms to predict corporate catch-all patterns.
- **Office 365 Verification**: Special deep handshake logic for O365/Microsoft domains.
- **Fast Async Processing**: Controlled parallel concurrency to complete thousands of requests in minutes.
- **GDPR & CCPA Compliant**: Automated suppression list checks to respect opt-outs.

***

### 💡 Key Use Cases

1. **Cold Email Marketing**: Clean lists before launching campaigns to keep bounce rates under 1% and preserve domain reputation.
2. **B2B Lead Generation**: Find verified emails for prospects using just their names and company domains.
3. **Database Maintenance**: Regularly clean and update CRM contacts.
4. **CRM Enrichment**: Automate lead discovery pipelines in CRM platforms.

***

### 📥 Input Parameters

To run this Actor, configure the following input parameters:

- **Operation Mode**: Select either `Find Emails` (Lead Finder) or `Verify Emails` (Email Verifier).
- **Leads Input List**: A text list with one entry per line:
  - For **Finder Mode**: Enter `First Last, domain.com` (e.g., `Sadique Shaikh, theinsightsview.com`).
  - For **Verifier Mode**: Enter raw emails (e.g., `sadique@theinsightsview.com`).
- **ValidatorMails API Key**: (Optional) Enter your ValidatorMails API key to use your website credit balance. Leave blank to pay-as-you-go directly on the Apify platform!
- **Concurrency Limit**: Number of parallel verification workers (default: 5).

***

### 📤 Output Data

Results are saved to your default Apify Dataset. Below is an example of the output JSON:

```json
{
  "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": ""
}
```

***

### 💰 Pricing & Credits

- **Verification Mode**: Charged at **$5.00 per 1,000 email verifications** ($0.005 per event).
- **Finder Mode**: Charged at **$10.00 per 1,000 discovered emails** ($0.01 per event).
- Failed checks or invalid lines are skipped and **not charged**.

***

### 📞 Support & Documentation

For full API documentation, visit [ValidatorMails.com](https://validatormails.com). For support, contact us via the help desk on our platform.

# Actor input Schema

## `mode` (type: `string`):

Choose whether you want to find new emails or verify existing email addresses.

## `api_key` (type: `string`):

Leave blank to pay directly via Apify's store pricing. If you are an active ValidatorMails website subscriber, enter your key to use your website credits instead.

## `api_url` (type: `string`):

The base HTTP API endpoint of your ValidatorMails server.

## `leads` (type: `string`):

One entry per line. For Find Emails: 'Full Name, domain.com' (e.g., Sadique Shaikh, theinsightsview.com). For Verify Emails: 'email@domain.com'.

## `concurrency_limit` (type: `integer`):

Maximum number of simultaneous API requests to make to prevent rate limiting.

## Actor input object example

```json
{
  "mode": "find",
  "api_url": "https://validatormails.com",
  "leads": "Sadique Shaikh, theinsightsview.com\nadmin@validatormails.com",
  "concurrency_limit": 5
}
```

# Actor output Schema

## `dataset` (type: `string`):

URL to the dataset containing the scraped or processed results.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "leads": `Sadique Shaikh, theinsightsview.com
admin@validatormails.com`
};

// Run the Actor and wait for it to finish
const run = await client.actor("thecfmarketing/validatormails-actor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "leads": """Sadique Shaikh, theinsightsview.com
admin@validatormails.com""" }

# Run the Actor and wait for it to finish
run = client.actor("thecfmarketing/validatormails-actor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "leads": "Sadique Shaikh, theinsightsview.com\\nadmin@validatormails.com"
}' |
apify call thecfmarketing/validatormails-actor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=thecfmarketing/validatormails-actor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/gixbhJgnWAToQgqhv/builds/3jgXRtxsRS6eITRRd/openapi.json