# Email Enricher+ - High-Fidelity Email Validation & Spam Trap (`foxpink/email-enricher-plus`) Actor Upload raw CSV/JSON contacts. This Actor cleans names and phones, verifies email syntax, checks DNS MX records, and performs SMTP handshake to confirm mailbox existence. GDPR-safe (no email stored after verification). Perfect for cold outreach, lead gen, and CRM import. - **URL**: https://apify.com/foxpink/email-enricher-plus.md - **Developed by:** [Nguyễn Anh Duy](https://apify.com/foxpink) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: 4.67 out of 5 stars ## Pricing from $0.01 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Email Enricher+ — High-Fidelity Validation & Spam Trap Detection [![Run on Apify](https://img.shields.io/badge/Run%20on%20Apify-FF7754?style=for-the-badge&logo=apify)](https://console.apify.com/actors/foxpink/email-enricher-plus) [![Apify Marketplace](https://img.shields.io/badge/Marketplace-FF7754?style=for-the-badge&logo=apify)](https://apify.com/foxpink/email-enricher-plus) [![GitHub Repo](https://img.shields.io/badge/Source%20Code-181717?style=for-the-badge&logo=github)](https://github.com/FoxPink/apify-email-enricher) [![Version](https://img.shields.io/badge/v1.4-blue?style=for-the-badge)]() > Upload raw CSV/JSON contacts. Clean names, phones, emails. Verify deliverability with DNS MX + SPF + SMTP handshake + Catch-All detection. **Zero DOM, never breaks.** Includes typoSuggestion (Levenshtein), spam trap detection, and 8-category qualityBreakdown. --- Tired of scrapers breaking every time Google Maps or LinkedIn updates their HTML layout? This Actor does not scrape web pages. Instead, it **cleans, standardizes, and verifies your existing cold leads** using pure network logic and protocol-level verification. Stop wasting your budget on high bounce rates that burn your cold email domains. Clean your data instantly with zero maintenance overhead. --- ### Key Features - **Layer 1: Intelligent Data Normalization** - Standardizes first/last names, strips messy characters from phone numbers, and formats them into clean strings. - **Layer 2: DNS MX & SPF Validation** - Automatically resolves Domain MX records to ensure the target domain can actually receive mail, and checks SPF configurations. - **Layer 3: SMTP Deep Handshake (Port 25)** - Performs a real-time protocol-level handshake with the destination mail server to verify if the specific mailbox exists **without ever sending an actual email**. - **Layer 3b: DNS-Verified Fallback** - When SMTP is disabled or the mail server blocks the handshake (timeout/refused), returns `DNS_VERIFIED` status — still actionable data indicating the domain accepts mail, just without mailbox-level confirmation. - **Layer 4: Catch-All Domain Detection** - Automatically tests if a domain accepts all emails (catch-all config) by sending a random fake email first. Flags these as `RISKY_CATCH_ALL`. Toggle off via `detectCatchAll: false` for faster runs. - **Layer 5: Pattern-Based Email Generation** - When email is missing but firstName+lastName+domain are provided, generates and tests 8 common email patterns (firstname.lastname@, f.lastname@, etc.) via SMTP handshake. Finds the working pattern automatically. - **Deliverability Scoring** - Every record gets a 0-100 score combining syntax, MX, SMTP, role-based, disposable, and catch-all signals. Filter by `score >= 80` for high-quality leads. - **100% Stable** - Built on pure network protocols. Since it has 0% dependency on web DOM structures, this Actor **never breaks** and requires zero maintenance. --- ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `records` | Array | required | Array of contact objects | | `performSmtpCheck` | Boolean | `true` | Enable SMTP handshake + Catch-All detection | | `detectCatchAll` | Boolean | `true` | Send fake email first to detect catch-all domains | | `generatePatterns` | Boolean | `true` | Generate & test email patterns when email is missing | | `smtpTimeout` | Integer | `8` | Seconds per SMTP connection (max 20) | | `defaultCountryCode` | String | `"+1"` | Country code prefix for phone numbers | | `maxConcurrency` | Integer | `5` | Parallel SMTP connections (max 20) | Each record in `records`: | Field | Type | Description | |-------|------|-------------| | `firstName` | String | (Optional) First name | | `lastName` | String | (Optional) Last name | | `email` | String | (Optional if firstName+lastName+domain provided) Email to verify | | `phone` | String | (Optional) Raw phone number | | `domain` | String | (Optional) Company domain for pattern generation (e.g. `company.com`) | #### Input Example ```json { "records": [ { "firstName": " John ", "lastName": "Doe", "email": "JOHN.DOE@GMAIL.COM", "phone": "+1 (555) 019-2834" } ], "performSmtpCheck": true, "detectCatchAll": true, "maxConcurrency": 5 } ```` *** ### Output The Actor returns a structured and enriched dataset: ````json [ { "firstName": "John", "lastName": "Doe", "fullName": "John Doe", "email": "john.doe@gmail.com", "domain": "gmail.com", "phone": "+15550192834", "emailSyntaxValid": true, "mxFound": true, "mxServer": "gmail-smtp-in.l.google.com", "spfRecord": "v=spf1 redirect=_spf.google.com", "smtpValid": true, "smtpReason": "accepted", "catchAll": false, "patternGenerated": false, "score": 95, "status": "DELIVERABLE" }, { "firstName": "Jane", "lastName": "Smith", "email": "jane@catchall-domain.com", "emailSyntaxValid": true, "mxFound": true, "mxServer": "mail.catchall-domain.com", "smtpValid": true, "smtpReason": "catch-all accepted", "catchAll": true, "status": "RISKY_CATCH_ALL" }, { "firstName": "Bob", "lastName": "Johnson", "email": "bob@tight-firewall.com", "emailSyntaxValid": true, "mxFound": true, "mxServer": "mx.tight-firewall.com", "spfRecord": "v=spf1 include:_spf.google.com ~all", "smtpValid": false, "smtpReason": "", "catchAll": false, "status": "DNS_VERIFIED" } ] --- #### Complete Output Fields | Field | Type | Description | |-------|------|-------------| | `firstName` | string | Normalized first name | | `lastName` | string | Normalized last name | | `fullName` | string | Combined full name | | `email` | string | Lowercased, trimmed email | | `domain` | string | Email domain extracted | | `phone` | string | Formatted E.164 phone | | `emailSyntaxValid` | boolean | RFC 5322 syntax check | | `mxFound` | boolean | Domain has MX records | | `mxServer` | string | Resolved mail server | | `spfRecord` | string | SPF policy (if found) | | `smtpValid` | boolean | Mailbox verified via SMTP | | `smtpReason` | string | SMTP response or error | | `catchAll` | boolean | Domain accepts all emails | | `isRoleBased` | boolean | Role-based email (info@, support@, etc.) | | `isDisposable` | boolean | Known disposable email domain | | `isFreeProvider` | boolean | Free provider (Gmail, Yahoo, etc.) | | `provider` | string | Email provider name | | `aliasType` | string | Plus-tag or dot alias detected | | `patternGenerated` | boolean | Email was generated via pattern testing | | `score` | integer | Deliverability score 0–100 | | `qualityBreakdown` | object | Per-category quality sub-scores | | `status` | string | `DELIVERABLE`, `RISKY_CATCH_ALL`, `DNS_VERIFIED`, or `INVALID` | --- ### Output Schema (API Endpoints) This Actor exposes the following outputs in the run API response: | Endpoint | Description | |----------|-------------| | `enrichedContacts` | Full dataset as JSON | | `deliverableOnly` | Filtered: only `DELIVERABLE` contacts | | `highQualityOnly` | Filtered: only score ≥ 80 contacts | | `summary` | Run statistics (last item with `_summary` key) | | `csvExport` | CSV file for Excel/CRM import | | `jsonExport` | Formatted JSON file for pipelines | #### API Usage (Python) ```python import requests resp = requests.get( "https://api.apify.com/v2/datasets/{dataset_id}/items", headers={"Authorization": "Bearer YOUR_API_TOKEN"} ) data = resp.json() for row in data: print(row["email"], row["status"]) ```` *** ### Pricing - **Pay per event:** $0.01 / 1,000 results. Average cost: ~$0.10 per 10,000 contacts - **No subscription:** Pay only for what you use. Runs within your Apify platform limits - **Enterprise:** Need custom CRM integration, dedicated proxy, or bulk discounts? Contact the developer. *** ### MCP / AI Agent Integration This Actor supports MCP (Model Context Protocol) for AI agent use. Configure in your MCP client: ```json { "mcpServers": { "apify": { "command": "npx", "args": ["-y", "@apify/mcp-server"], "env": { "APIFY_TOKEN": "YOUR_API_TOKEN" } } } } ``` The dataset schema includes rich field descriptions so AI agents can understand and chain this Actor's output with other tools automatically. # Actor input Schema ## `records` (type: `array`): Array of contact objects with firstName, lastName, email (required), phone (or upload CSV via input tab) ## `performSmtpCheck` (type: `boolean`): Perform SMTP handshake + Catch-All detection. Takes ~7s per email. Disable for bulk mode. ## `detectCatchAll` (type: `boolean`): Send a fake email first to detect if domain accepts all emails. Only works when SMTP check is enabled. ## `smtpTimeout` (type: `integer`): Timeout per SMTP connection. Increase for slow mail servers. ## `defaultCountryCode` (type: `string`): e.g. +1 for US, +44 for UK. Used when phone has no prefix. ## `generatePatterns` (type: `boolean`): When email is empty but firstName+lastName+domain provided, generate and test common email patterns. Only works when SMTP check is enabled. ## `maxConcurrency` (type: `integer`): Number of simultaneous SMTP connections. Lower to avoid rate limits. ## Actor input object example ```json { "records": [], "performSmtpCheck": true, "detectCatchAll": true, "smtpTimeout": 8, "defaultCountryCode": "+1", "generatePatterns": true, "maxConcurrency": 5 } ``` # Actor output Schema ## `enrichedContacts` (type: `string`): Primary output: JSON array of cleaned and verified contact records. Each record includes standardized name, email, phone, DNS MX results, SPF policy, Catch-All detection, SMTP handshake status, typo suggestion, spam trap detection, and a final deliverability status (DELIVERABLE | DNS\_VERIFIED | RISKY\_CATCH\_ALL | UNDELIVERABLE | UNKNOWN). Use this endpoint to fetch all verified contacts for CRM import, cold email campaigns, or lead scoring. ## `deliverableOnly` (type: `string`): Filtered view: only contacts verified as DELIVERABLE (confirmed mailbox via SMTP handshake, excluding catch-all domains). Ideal for high-stakes cold outreach campaigns where bounce rate must be near zero and domain reputation matters. Combine with RISKY\_CATCH\_ALL results to assess overall list quality. ## `highQualityOnly` (type: `string`): Filtered view: only contacts with a deliverability score of 80 or higher. Combines syntax validity, MX records, SMTP confirmation, and negative signals (role-based, disposable, catch-all) into a single 0-100 score. Ideal for high-stakes campaigns where deliverability is critical. ## `summary` (type: `string`): Aggregate statistics for the entire run: total records processed, valid syntax count, valid MX count, SMTP-checked count, deliverable count, DNS verified count (MX pass, SMTP not performed or blocked), risky catch-all count, undeliverable count, unknown count, invalid syntax count, pattern-generated emails, average score, and high-quality count (score ≥ 80). The summary is stored as the last dataset item with key '\_summary'. Useful for cost calculation, list quality assessment, and automated reporting. ## `csvExport` (type: `string`): Download all enriched contacts as a CSV file (comma-delimited) ready for Excel, Google Sheets, HubSpot, Salesforce, or any CRM platform. Columns: firstName, lastName, fullName, email, domain, phone, status, catchAll, emailSyntaxValid, mxFound, mxServer, spfRecord, smtpValid, smtpReason. ## `jsonExport` (type: `string`): Download all enriched contacts as a formatted JSON file with indentation for readability. Suitable for API pipelines, ETL processes, and developer handoff. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "records": [] }; // Run the Actor and wait for it to finish const run = await client.actor("foxpink/email-enricher-plus").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "records": [] } # Run the Actor and wait for it to finish run = client.actor("foxpink/email-enricher-plus").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 '{ "records": [] }' | apify call foxpink/email-enricher-plus --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=foxpink/email-enricher-plus", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Email Enricher+ - High-Fidelity Email Validation & Spam Trap", "description": "Upload raw CSV/JSON contacts. This Actor cleans names and phones, verifies email syntax, checks DNS MX records, and performs SMTP handshake to confirm mailbox existence. GDPR-safe (no email stored after verification). Perfect for cold outreach, lead gen, and CRM import.", "version": "1.4", "x-build-id": "SgrsJ7tIfBNFE6KQs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxpink~email-enricher-plus/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxpink-email-enricher-plus", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/foxpink~email-enricher-plus/runs": { "post": { "operationId": "runs-sync-foxpink-email-enricher-plus", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/foxpink~email-enricher-plus/run-sync": { "post": { "operationId": "run-sync-foxpink-email-enricher-plus", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "records": { "title": "Contact Records", "minItems": 0, "type": "array", "description": "Array of contact objects with firstName, lastName, email (required), phone (or upload CSV via input tab)", "items": { "type": "object", "properties": { "email": { "title": "Email Address", "type": "string", "description": "Email address to verify (optional if firstName+lastName+domain provided for pattern generation)" }, "firstName": { "title": "First Name", "type": "string", "description": "First name (optional)" }, "lastName": { "title": "Last Name", "type": "string", "description": "Last name (optional)" }, "phone": { "title": "Phone Number", "type": "string", "description": "Raw phone number (optional)" }, "domain": { "title": "Domain (for pattern generation)", "type": "string", "description": "Company domain to generate email patterns when email is missing (e.g. 'company.com'). Requires firstName or lastName." } } } }, "performSmtpCheck": { "title": "Verify SMTP (deep check)", "type": "boolean", "description": "Perform SMTP handshake + Catch-All detection. Takes ~7s per email. Disable for bulk mode.", "default": true }, "detectCatchAll": { "title": "Detect Catch-All Domains", "type": "boolean", "description": "Send a fake email first to detect if domain accepts all emails. Only works when SMTP check is enabled.", "default": true }, "smtpTimeout": { "title": "SMTP Timeout (seconds)", "minimum": 3, "maximum": 30, "type": "integer", "description": "Timeout per SMTP connection. Increase for slow mail servers.", "default": 8 }, "defaultCountryCode": { "title": "Default Country Code for Phone", "type": "string", "description": "e.g. +1 for US, +44 for UK. Used when phone has no prefix.", "default": "+1" }, "generatePatterns": { "title": "Generate Email Patterns", "type": "boolean", "description": "When email is empty but firstName+lastName+domain provided, generate and test common email patterns. Only works when SMTP check is enabled.", "default": true }, "maxConcurrency": { "title": "Max concurrent checks", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of simultaneous SMTP connections. Lower to avoid rate limits.", "default": 5 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```