# Email List Validator (syntax, domain, MX, disposable) (`psypherz/email-list-validator`) Actor

Clean an email list before you send: syntax, domain and MX checks, disposable and role address detection, typo suggestions. Up to 100,000 emails per run. Stores nothing.

- **URL**: https://apify.com/psypherz/email-list-validator.md
- **Developed by:** [Muhammad Yasin Bin Abdul Rahman](https://apify.com/psypherz) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.26 / 1,000 email checkeds

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/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 List Validator (syntax, domain, MX, disposable)

Clean an email list before you send. Every address gets a status (valid, risky, invalid or unknown), a plain reason, and each check behind it: syntax, whether the domain exists and accepts mail (MX records), disposable domains, role addresses like info@, free providers, and typo suggestions such as gmial.com to gmail.com.

**Price: US$0.0003 per email, plus a US$0.001 run fee.** 10,000 emails cost US$3.001. Emails whose domain's DNS does not answer are marked "unknown" and not charged.

### What people use it for

- **Pre-clean before an SMTP verifier:** drop dead domains, typos and throwaway addresses first, so you pay a full verifier only for the rest.
- **Sign-up form audits:** find disposable and mistyped addresses in your user list.
- **CRM hygiene:** flag role addresses and domains that no longer accept mail.
- **Lead list checks:** reject lists with too many dead domains before you import them.

### What it checks, and what it does not

- Checks: address syntax (RFC 5321/5322 rules in practice), domain exists, domain accepts mail (MX, or the A record fallback; RFC 7505 "null MX" counts as no mail), disposable domain list (about 10,000 domains), role address, free provider, common typos.
- Does not check whether a mailbox exists. That needs an SMTP connection on port 25, which Apify blocks for Actors. Use this Actor as the cheap first pass.

### Privacy

- Addresses are processed in memory for your run only and written only to your own run's dataset.
- Nothing is kept by the developer after the run. Addresses are never written to the run log, which shows counts only.
- No email is sent to any address, and no third-party verification service is called. The only outside lookups are DNS queries for each domain.

### Input

- `emails`: list of addresses, up to 100,000 per run. Text with commas or new lines also works.
- `removeDuplicates` (default true): check each address once.

### Example output

Real output from the sample input (30 Oct 2026).

| email | status | reason | didYouMean |
|---|---|---|---|
| support@github.com | risky | Role address (shared inbox such as info@ or support@). |  |
| jane.doe@gmial.com | risky | Looks like a typo of a common provider. | jane.doe@gmail.com |
| test@mailinator.com | risky | Disposable (throwaway) email domain. |  |
| someone@no-such-domain-zz9.com | invalid | Domain does not exist. |  |
| not-an-email | invalid | Syntax: not a single address with one @. |  |

One full item:

```json
{
  "email": "jane.doe@gmial.com",
  "status": "risky",
  "reason": "Looks like a typo of a common provider.",
  "normalizedEmail": "jane.doe@gmial.com",
  "domain": "gmial.com",
  "syntaxValid": true,
  "domainExists": true,
  "acceptsMail": true,
  "mxHosts": [
    "gmial.com"
  ],
  "isDisposable": true,
  "isRoleAccount": false,
  "isFreeProvider": false,
  "didYouMean": "jane.doe@gmail.com",
  "checkedAt": "2026-10-30T17:09:34+00:00"
}
```

### Status meanings

- **valid:** syntax is fine and the domain accepts mail; not disposable, not a role address, no typo found.
- **risky:** deliverable domain, but disposable, a likely typo, or a role address.
- **invalid:** bad syntax, the domain does not exist, or it accepts no mail.
- **unknown:** the domain's DNS did not answer in time. Not charged; run these again later.

### Limits

- 100,000 emails per run. Split bigger lists across runs.
- Free Apify plan: 100 emails per run.
- One DNS lookup per domain, 50 at a time; a list of 10,000 emails usually finishes in a few minutes.

### FAQ

**Is "valid" a guarantee that the email will not bounce?** No. It means the domain accepts mail. A mailbox can still be closed or full.

**Why is my company's support@ address "risky"?** Role addresses are shared inboxes. Many email platforms treat them as a higher complaint risk for marketing mail.

**Can an AI agent call it?** Yes. Compact JSON with stable field names and pay-per-event pricing.

### More tools from the same developer

Same style: clean JSON output, pay only for results, no charge on failed items.

| Tool | What it does |
|---|---|
| [Bulk Keyword Search Volume](https://apify.com/PsypherZ/keyword-search-volume) | Google Ads search volume, CPC, competition and 12-month trend for up to 10,000 keywords |
| [Google Keyword Ideas](https://apify.com/PsypherZ/google-keyword-ideas) | Hundreds of keyword ideas per seed with volume, CPC, difficulty and search intent |
| [Amazon Keyword Search Volume](https://apify.com/PsypherZ/amazon-keyword-volume) | Monthly Amazon searches for up to 10,000 keywords in 16 markets, plus related keywords |
| [Competitor Keywords](https://apify.com/PsypherZ/competitor-keywords) | Every Google keyword a domain ranks for, with traffic, plus its closest competitors |
| [Google Trends API](https://apify.com/PsypherZ/google-trends-api) | Interest over time, by region, and rising queries and topics for up to 500 keywords |
| [Google SERP Results](https://apify.com/PsypherZ/google-serp-results) | Organic results, featured snippets and People Also Ask for any keyword, country and device |
| [AI Brand Visibility Tracker](https://apify.com/PsypherZ/ai-brand-visibility) | Which brands ChatGPT, Claude, Gemini and Perplexity recommend, and where yours ranks |
| [Google AI Overview Tracker](https://apify.com/PsypherZ/google-ai-overview-tracker) | Which keywords show an AI Overview, what it says, and whether it cites your site |
| [Audio and Video Transcriber](https://apify.com/PsypherZ/audio-video-transcriber) | Timestamped transcripts from audio and video files in 90+ languages |
| [Subtitle Generator](https://apify.com/PsypherZ/subtitle-generator) | Ready-to-use SRT and WebVTT subtitles from audio and video files |
| [Podcast Transcriber](https://apify.com/PsypherZ/podcast-transcriber) | Timestamped transcripts of podcast episodes from any RSS feed or Apple Podcasts link |
| [Image OCR](https://apify.com/PsypherZ/image-ocr) | Text from images in 20 languages, with confidence scores |
| [AI Image Upscaler](https://apify.com/PsypherZ/image-upscaler) | Upscale photos and artwork 2x, 3x or 4x with Real-ESRGAN AI |
| [PDF to Text and Markdown](https://apify.com/PsypherZ/pdf-to-text-markdown) | Clean text and Markdown from PDFs, with OCR for scanned pages |
| [Bulk PageSpeed Insights Audit](https://apify.com/PsypherZ/bulk-pagespeed-audit) | Core Web Vitals and Lighthouse scores for many pages, mobile and desktop |
| [HTTP Request Runner](https://apify.com/PsypherZ/http-request-runner) | Send thousands of GET, POST and other API requests and get status, headers and body back |
| [Bulk File Downloader](https://apify.com/PsypherZ/bulk-file-downloader) | Save up to 5,000 direct file links to storage, each with a download link and checksum |
| [Video Frame Extractor](https://apify.com/PsypherZ/video-frame-extractor) | Still images from video files every N seconds, at set times, or evenly spaced |

# Actor input Schema

## `emails` (type: `array`):

One address per line. Up to 100,000 per run.

## `removeDuplicates` (type: `boolean`):

Check each address once, even if it appears several times.

## Actor input object example

```json
{
  "emails": [
    "support@github.com",
    "jane.doe@gmial.com",
    "test@mailinator.com",
    "someone@no-such-domain-zz9.com",
    "not-an-email"
  ],
  "removeDuplicates": true
}
```

# Actor output Schema

## `results` (type: `string`):

One row per email: status (valid, risky, invalid, unknown), reason and every check.

# 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 = {
    "emails": [
        "support@github.com",
        "jane.doe@gmial.com",
        "test@mailinator.com",
        "someone@no-such-domain-zz9.com",
        "not-an-email"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("psypherz/email-list-validator").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 = { "emails": [
        "support@github.com",
        "jane.doe@gmial.com",
        "test@mailinator.com",
        "someone@no-such-domain-zz9.com",
        "not-an-email",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("psypherz/email-list-validator").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 '{
  "emails": [
    "support@github.com",
    "jane.doe@gmial.com",
    "test@mailinator.com",
    "someone@no-such-domain-zz9.com",
    "not-an-email"
  ]
}' |
apify call psypherz/email-list-validator --silent --output-dataset

```

## MCP server setup

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

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/v2cYxY0ZkLKmoEBK3/builds/ftpsxFh9KFDvttiCg/openapi.json