# Email Finder & Verifier API — Find Verified B2B Emails (`qualifyops/email-finder-verified`) Actor

Email finder + verifier: give a name and company domain, get their verified, deliverable work email — live SMTP check, catch-all excluded, no bounces. Find and verify anyone's business email before you send. Pay only per verified email found. B2B leads, cold email, sales prospecting.

- **URL**: https://apify.com/qualifyops/email-finder-verified.md
- **Developed by:** [QualifyOps](https://apify.com/qualifyops) (community)
- **Categories:** Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 229 total users, 51 monthly users, 97.8% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 verified email founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Email Finder & Verifier API — Find Verified B2B Emails

**You give:** names + company domains directly, or a CSV/XLSX/Google Sheets file, or an Apify Dataset ID.
**You get:** their **verified, deliverable email address** — one confirmed mailbox, with a confidence score, marked **FOUND** or **NOT_FOUND**.
**You pay:** **only per verified email found — $0.008.** Not-found is **free**.

No LinkedIn, no scraping of protected sources. This is a deterministic **pattern engine** plus **live deliverability verification** — the two things that actually turn a name into an address you can send to.

#### Have LinkedIn profile URLs instead?

Use **[LinkedIn Email Finder — Verified Emails, No Cookies](https://apify.com/qualifyops/linkedin-email-finder-verified)**. Paste LinkedIn URLs/usernames and get profile + company context with a deliverability-checked email. **$0.03 only when a verified email is found.**

***

#### Need LinkedIn-based bulk prospecting?

Already have **LinkedIn profile URLs**? Use **Bulk LinkedIn Email Finder — Verified Emails, No Cookies**: https://apify.com/qualifyops/linkedin-email-finder-verified

Starting from **target companies** and need to discover employees or decision-makers first? Use **LinkedIn Company Employees Scraper + Verified Email Finder**: https://apify.com/qualifyops/linkedin-company-employees-email-finder

That gives you a simple QualifyOps ladder: **name + domain → this Actor; profile URLs → Bulk LinkedIn Email Finder; companies → Company Employees + Email Finder.**

#### Bulk input without JSON

You do not need to hand-format a JSON array. Paste a **CSV or Excel file URL**, a shareable **Google Sheets link**, or an **Apify Dataset ID** from another Actor. Common name and domain/website column names are detected automatically.

#### Lower-cost verification waterfall

Candidates are verified in rounds: the highest-probability corporate formats are tried first (`first.last`, `flast`, `first`, `firstlast`). The default cap is four verifier attempts per person; deeper patterns remain available as an advanced override. This keeps the strict SMTP/catch-all gate while bounding verification cost.

#### Why "verified" is the whole point

Most email finders hand you `first.last@company.com` and call it a day. You send, it bounces, and your domain reputation takes the hit. Here, every `FOUND` address has been through:

> pattern generation → syntax → MX record → **live SMTP mailbox check** → catch-all detection → confidence score

Only an address that a real mail server **accepts**, that is **not catch-all**, at **confidence ≥ 0.80**, is returned as `FOUND`. Everything else is `NOT_FOUND` with a reason and a clearly-labelled `best_guess` — never a silent, billed guess.

#### How it works

1. **Normalize** the name (lowercase, strip accents/punctuation) and the domain (strip `https://`, `www.`, paths — full URLs are fine).
2. **Generate candidates** in priority order: `first.last`, `flast`, `first`, `firstlast`, `f.last`, `first_last`, `last.first`, `lastf`, `first-last`, `last` — each `@domain`.
3. **Optional site scan** (`siteScan`, on by default): fetch the company's homepage, `/contact` and `/about` and promote any **published** address that matches a candidate to the front — those are real, not guesses.
4. **Local pre-filter (free):** drop bad-syntax candidates and, if the domain has **no MX record at all**, return `NOT_FOUND` immediately — with **no charge**.
5. **One batched deliverability check:** survivors go to a proven Apify Store validator with real SMTP egress, in a single call per run.
6. **Pick the winner:** the first deliverable, non-catch-all, confident address becomes `FOUND`. **You are charged only for FOUND.**

#### What each row gives you

| Column | Meaning |
|---|---|
| `action` | **FOUND** (verified deliverable) or **NOT_FOUND** (with reason) |
| `firstName` / `lastName` | The person you asked about |
| `domain` | The normalized company domain |
| `verified_email` | The deliverable address — **only on FOUND** |
| `pattern` | Which pattern won (`first.last`, `flast`, `published`, …) |
| `confidence` | 0–1 deliverability confidence |
| `source` | `pattern` (generated) or `published` (found on the company site) |
| `candidates_checked` | How many addresses were tested |
| `reason` | On NOT_FOUND: `catch_all_domain` / `all_rejected` / `no_mx` / `verifier_unavailable` |
| `best_guess` / `best_guess_confidence` | On NOT_FOUND: the most-likely address, **clearly not verified** |

#### Honest by design

- We **never invent** an address and label it verified. `FOUND` means a live mail server accepted that specific mailbox.
- **Catch-all domains** — which accept everything and confirm nothing — are returned as `NOT_FOUND` (`catch_all_domain`) and **are not charged**. We will not bill you for a domain that cannot actually confirm the person.
- If the verifier is unavailable, we degrade to `NOT_FOUND` (`verifier_unavailable`) — never a fabricated "deliverable" result, never a charge.
- A `best_guess` is always presented as a guess, never as a verified address.

#### For agents & automation

Call it via the Apify **API** or **MCP**. Pass an array of `{firstName, lastName, domain}` (or `{fullName, domain}`) and get back deduped, verified rows — ideal as a step in an enrichment pipeline. **Schedule** it for recurring enrichment of a lead list into your CRM or sequencer. You pay only for the addresses that are actually deliverable.

***

*Input: `people` (array of name + domain). Optional: `maxCandidatesPerPerson` (cost cap), `siteScan`, `verifierActorId`, `requestTimeoutSecs`.*

# Actor input Schema

## `people` (type: `array`):

Each item needs a name plus company domain/website. For bulk lists, use CSV / Excel / Google Sheets or an Apify dataset below.

## `csvFile` (type: `string`):

Paste a public CSV/XLSX file URL or a Google Sheets share link. Common columns are auto-detected: first name, last name/full name, domain/website.

## `datasetId` (type: `string`):

Chain directly from another Actor. Pass its dataset ID and common name/domain columns are auto-detected.

## `maxInputRows` (type: `integer`):

Safety cap for file or dataset imports.

## `maxCandidatesPerPerson` (type: `integer`):

Maximum email patterns to verify per person. Default 4 covers the dominant corporate formats while capping verification cost; raise it only when you need deeper pattern coverage.

## `siteScan` (type: `boolean`):

Fetch homepage, /contact and /about and promote any published address that matches a candidate (real, not a guess).

## `verifierActorId` (type: `string`):

SMTP/catch-all validator used for final deliverability checks. Advanced override; the default is optimized for low-cost bulk verification.

## `requestTimeoutSecs` (type: `integer`):

How long to wait for each company web page during the optional site scan.

## Actor input object example

```json
{
  "people": [
    {
      "firstName": "Patrick",
      "lastName": "Collison",
      "domain": "stripe.com"
    },
    {
      "firstName": "Tobi",
      "lastName": "Lutke",
      "domain": "shopify.com"
    }
  ],
  "maxInputRows": 5000,
  "maxCandidatesPerPerson": 4,
  "siteScan": true,
  "verifierActorId": "bounceverify/bounceverify-email-verifier",
  "requestTimeoutSecs": 20
}
```

# 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 = {
    "people": [
        {
            "firstName": "Patrick",
            "lastName": "Collison",
            "domain": "stripe.com"
        },
        {
            "firstName": "Tobi",
            "lastName": "Lutke",
            "domain": "shopify.com"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("qualifyops/email-finder-verified").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 = { "people": [
        {
            "firstName": "Patrick",
            "lastName": "Collison",
            "domain": "stripe.com",
        },
        {
            "firstName": "Tobi",
            "lastName": "Lutke",
            "domain": "shopify.com",
        },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("qualifyops/email-finder-verified").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "people": [
    {
      "firstName": "Patrick",
      "lastName": "Collison",
      "domain": "stripe.com"
    },
    {
      "firstName": "Tobi",
      "lastName": "Lutke",
      "domain": "shopify.com"
    }
  ]
}' |
apify call qualifyops/email-finder-verified --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,qualifyops/email-finder-verified"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Oz438DncDPcCgUUJJ/builds/haSkItvxPvOOdApyf/openapi.json