Catchall Email Verification (Source of truth, + discounts)

Pricing

from $7.80 / 1,000 verifications

Try for free

Go to Apify Store

Catchall Email Verification (Source of truth, + discounts)

Try for free

Developed by

Code Maggot

Maintained by Community

Post SMTP email verification that serves as a definitive, single source of truth for business email account existence across Workspace/Microsoft 365 (to date).

0.0 (0)

Pricing

from $7.80 / 1,000 verifications

Last modified

12 days ago

Lead generation

Automation

Open source

.actor/actor.json

{
  "actorSpecification": 1,
  "name": "catchall-verification",
  "title": "Catchall Email Verification",
  "description": "Apify actor for the Catchall Email Verification API.",
  "version": "1.0",
  "buildTag": "latest",
  "meta": {
    "template": "python"
  },
  "environmentVariables": {
    "APIFY_ESP_CATCHALL_BASEURL": "@APIFY_ESP_CATCHALL_BASEURL",
    "APIFY_API_TOKEN": "@APIFY_API_TOKEN"
  },
  "readme": "../README.md",
  "dockerfile": "../Dockerfile",
  "input": "./input_schema.json",
  "storages": {
    "dataset": "./dataset_schema.json"
  },
  "minMemoryMbytes": 128,
  "maxMemoryMbytes": 128
}

.actor/dataset_schema.json

{
  "actorSpecification": 1,
  "title": "Email Verification Results",
  "description": "Results from catchall email verification",
  "views": {
    "overview": {
      "title": "Email Verification Overview",
      "transformation": {
        "fields": [
          "email",
          "success", 
          "score",
          "message",
          "response_time",
          "created_at"
        ]
      },
      "display": {
        "component": "table",
        "properties": {
          "email": {
            "label": "Email Address",
            "format": "text"
          },
          "success": {
            "label": "Verification Success",
            "format": "boolean"
          },
          "score": {
            "label": "Verification Score",
            "format": "text"
          },
          "message": {
            "label": "Status Message",
            "format": "text"
          },
          "response_time": {
            "label": "Response Time (ms)",
            "format": "number"
          },
          "created_at": {
            "label": "Created At",
            "format": "text"
          }
        }
      }
    }
  }
}

.actor/input_schema.json

{
  "title": "Catchall Email Verification",
  "description": "Actor that verifies catchall email addresses beyond the usual SMTP handshake method",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "emails": {
      "title": "Email addresses",
      "description": "List of email addresses to verify",
      "type": "array",
      "editor": "json",
      "prefill": ["xwang@obsidiansecurity.com"]
    }
  },
  "required": ["emails"]
}

src/init.py

src/main.py

1import asyncio
2
3from .main import main
4
5# Execute the Actor entry point.
6asyncio.run(main())

src/main.py

1"""Module defines the main entry point for the Apify Actor.
2
3Feel free to modify this file to suit your specific needs.
4
5To build Apify Actors, utilize the Apify SDK toolkit, read more at the official documentation:
6https://docs.apify.com/sdk/python
7"""
8
9from __future__ import annotations
10
11import json
12import os
13import time
14import urllib.request
15import urllib.parse
16import asyncio
17from typing import Optional
18
19
20from apify import Actor
21
22
23def _split_base_url(raw: str) -> tuple[str, str]:
24    """Split APIFY_ESP_CATCHALL_BASEURL into (origin, path_prefix).
25    origin = scheme://host[:port]
26    path_prefix = normalized leading path, e.g. '' or '/api' or '/custom/yc'
27    """
28    parsed = urllib.parse.urlparse(raw)
29    if not parsed.scheme or not parsed.netloc:
30        raise RuntimeError(f"Invalid APIFY_ESP_CATCHALL_BASEURL: {raw}")
31    origin = f"{parsed.scheme}://{parsed.netloc}"
32    # Normalize prefix: ensure leading slash, no trailing slash (except root '')
33    prefix = parsed.path or ''
34    if prefix and not prefix.startswith('/'):
35        prefix = '/' + prefix
36    if prefix.endswith('/') and len(prefix) > 1:
37        prefix = prefix[:-1]
38    return origin, prefix
39
40
41
42def http_request(base_url: str, method: str, path: str, headers: dict, data: Optional[dict] = None):
43    url = urllib.parse.urljoin(base_url.rstrip('/') + '/', path.lstrip('/'))
44    body_bytes = None
45    if data is not None:
46        body_bytes = json.dumps(data).encode('utf-8')
47        headers.setdefault('Content-Type', 'application/json')
48    req = urllib.request.Request(url=url, data=body_bytes, headers=headers, method=method)
49    with urllib.request.urlopen(req, timeout=60) as resp:
50        resp_body = resp.read().decode('utf-8')
51        status = resp.getcode()
52        return status, json.loads(resp_body) if resp_body else None
53
54
55
56async def main() -> None:
57    async with Actor:
58        # Get inputs from Apify
59        input_ = await Actor.get_input() or {}
60        emails = input_.get('emails', [])
61
62        if not emails:
63            raise RuntimeError('Input must contain "emails" array with email addresses to verify')
64
65        # Get environment variables
66        base_url = os.getenv('APIFY_ESP_CATCHALL_BASEURL')
67        api_token = os.getenv('APIFY_API_TOKEN')
68
69        if not base_url:
70            raise RuntimeError('Missing APIFY_ESP_CATCHALL_BASEURL environment variable')
71
72        if not api_token:
73            raise RuntimeError('Missing APIFY_API_TOKEN environment variable')
74
75        # Split base URL into origin and path prefix
76        try:
77            base_origin, path_prefix = _split_base_url(base_url)
78        except Exception as e:
79            raise RuntimeError(str(e))
80
81        # Check user limits
82        is_paid_user = os.getenv('ACTOR_MAX_PAID_DATASET_ITEMS') is not None
83
84        if not is_paid_user:
85            Actor.log.info('Free account detected - limiting to 1 email per job. Upgrade to paid for unlimited emails.')
86            if len(emails) > 1:
87                disregarded_count = len(emails) - 1
88                emails = emails[:1]  # Keep only first email
89                Actor.log.info(f'Disregarding {disregarded_count} additional emails due to free account limit.')
90        else:
91            Actor.log.info('Paid account detected - no email limits applied.')
92
93        Actor.log.info('Starting email verification job...')
94
95        # Prepare request data
96        job_data = {
97            "emails": emails
98        }
99
100        # Trigger job: POST /attempt/job
101        raw_path_job = '/attempt/job'
102        effective_path_job = (path_prefix + raw_path_job) or raw_path_job
103        auth_header = f"Bearer {api_token}"
104
105        status, payload = http_request(
106            base_origin, 'POST', effective_path_job,
107            headers={'Authorization': auth_header},
108            data=job_data,
109        )
110
111        # Accept any 2xx response as success as long as a job_id is provided.
112        # Some deployments may return 200 OK instead of 202 Accepted when queuing the job.
113        if (status // 100) != 2 or not payload or 'job_id' not in payload:
114            raise RuntimeError(f'Failed to trigger email verification job: status={status}, payload={payload}')
115
116        job_id = payload['job_id']
117        Actor.log.info(f'Email verification job queued: {job_id}')
118
119        # Log dropped emails if any
120        dropped_emails = payload.get('dropped_emails', [])
121        if dropped_emails:
122            dropped_count = len([d for d in dropped_emails if not d.get('email', '').startswith('...and ')])
123            Actor.log.info(f'Dropped {dropped_count} unsupported emails: {[d["email"] for d in dropped_emails if not d["email"].startswith("...and ")]}')
124
125        # Poll job status every 30 seconds up to 90 minutes
126        deadline = time.time() + 90 * 60
127        interval = 30
128        last_status = None
129
130        while time.time() < deadline:
131            # Check job status: GET /attempt/job/{job_id}
132            raw_path_status = f'/attempt/job/{job_id}'
133            effective_path_status = (path_prefix + raw_path_status) or raw_path_status
134
135            try:
136                status_code, job_payload = http_request(
137                    base_origin, 'GET', effective_path_status,
138                    headers={'Authorization': auth_header},
139                )
140            except Exception as e:
141                Actor.log.warning(f'Error polling job status: {e}')
142                await asyncio.sleep(interval)
143                continue
144
145            if status_code != 200 or not job_payload:
146                Actor.log.warning(f'Unexpected job status response: {status_code} {job_payload}')
147                await asyncio.sleep(interval)
148                continue
149
150            # Check if we have results with length > 0
151            results = job_payload.get('results', [])
152            if isinstance(results, list) and len(results) > 0:
153                Actor.log.info(f'Found {len(results)} results. Job completed successfully.')
154                await Actor.set_value('RESULT', job_payload)
155
156                # Filter for successful results only
157                successful_results = [
158                    result for result in results
159                    if result.get("success", False)
160                ]
161
162                # Push successful results to dataset
163                if successful_results:
164                    await Actor.push_data(successful_results)
165                    Actor.log.info(f'Successfully pushed {len(successful_results)} verified emails to dataset.')
166                else:
167                    Actor.log.info('No successful email verifications found.')
168
169                return
170
171            last_status = job_payload.get('status')
172            Actor.log.info(f'Job status: {last_status} - waiting for results...')
173
174            await asyncio.sleep(interval)
175
176        # Timeout
177        Actor.log.error('Email verification job did not complete within timeout. Returning last known status.')
178        await Actor.set_value('RESULT', {
179            'job_id': job_id,
180            'status': last_status or 'unknown',
181            'message': 'timeout',
182        })

src/py.typed

.dockerignore

.git
.mise.toml
.nvim.lua
storage

# The rest is copied from https://github.com/github/gitignore/blob/main/Python.gitignore

# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
#  Usually these files are written by a python script from a template
#  before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
.pybuilder/
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
#   For a library or package, you might want to ignore these files since the code is
#   intended to run in multiple environments; otherwise, check them in:
.python-version

# pdm
#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
#   in version control.
#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
.pdm.toml
.pdm-python
.pdm-build/

# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/

# Celery stuff
celerybeat-schedule
celerybeat.pid

# SageMath parsed files
*.sage.py

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# pytype static type analyzer
.pytype/

# Cython debug symbols
cython_debug/

# PyCharm
#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
#  and can be added to the global gitignore or merged into this file.  For a more nuclear
#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
.idea/

# Visual Studio Code
#  Ignores the folder created by VS Code when changing workspace settings, doing debugger
#  configuration, etc. Can be commented out to share Workspace Settings within a team
.vscode

# Zed editor
#  Ignores the folder created when setting Project Settings in the Zed editor. Can be commented out
#  to share Project Settings within a team
.zed

.gitignore

.mise.toml
.nvim.lua
storage

# The rest is copied from https://github.com/github/gitignore/blob/main/Python.gitignore

# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
#  Usually these files are written by a python script from a template
#  before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
.pybuilder/
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
#   For a library or package, you might want to ignore these files since the code is
#   intended to run in multiple environments; otherwise, check them in:
.python-version

# pdm
#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
#   in version control.
#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
.pdm.toml
.pdm-python
.pdm-build/

# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/

# Celery stuff
celerybeat-schedule
celerybeat.pid

# SageMath parsed files
*.sage.py

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# pytype static type analyzer
.pytype/

# Cython debug symbols
cython_debug/

# PyCharm
#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
#  and can be added to the global gitignore or merged into this file.  For a more nuclear
#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
.idea/

# Visual Studio Code
#  Ignores the folder created by VS Code when changing workspace settings, doing debugger
#  configuration, etc. Can be commented out to share Workspace Settings within a team
.vscode

# Zed editor
#  Ignores the folder created when setting Project Settings in the Zed editor. Can be commented out
#  to share Project Settings within a team
.zed

# Added by Apify CLI
node_modules

Dockerfile

# First, specify the base Docker image.
# You can see the Docker images from Apify at https://hub.docker.com/r/apify/.
# You can also use any other image from Docker Hub.
FROM apify/actor-python:3.13

# Second, copy just requirements.txt into the Actor image,
# since it should be the only file that affects the dependency install in the next step,
# in order to speed up the build
COPY requirements.txt ./

# Install the packages specified in requirements.txt,
# Print the installed Python version, pip version
# and all installed packages with their versions for debugging
RUN echo "Python version:" \
 && python --version \
 && echo "Pip version:" \
 && pip --version \
 && echo "Installing dependencies:" \
 && pip install -r requirements.txt \
 && echo "All installed Python packages:" \
 && pip freeze

# Next, copy the remaining files and directories with the source code.
# Since we do this after installing the dependencies, quick build will be really fast
# for most source file changes.
COPY . ./

# Use compileall to ensure the runnability of the Actor Python code.
RUN python3 -m compileall -q src/

# Specify how to launch the source code of your Actor.
# By default, the "python3 -m ." command is run
CMD ["python3", "-m", "src"]

requirements.txt

1# Feel free to add your Python dependencies below. For formatting guidelines, see:
2# https://pip.pypa.io/en/latest/reference/requirements-file-format/
3
4apify < 3.0.0

Email Verifier

losoft.dev/email-verifier

Validates email addresses using syntax checking, DNS verification, disposable email detection, and role-based email identification.

Lorenz Hilpert

Email Validator Pro 📧

giovannibiancia/email-validator

Advanced email validation actor for Apify platform with comprehensive verification capabilities including SMTP verification, MX record checks, and disposable email detection.

Giovanni Bianciardi

Microsoft Catch-All Email Verifier

minion_hub/microsoft-catchall-email-verification

An Apify Actor that verifies Microsoft-hosted email addresses, including Outlook and Office365. It supports batch verification, sends results via HTTP POST to a webhook, and logs data to a dataset.

MinionHub

Email check, verify, validate

anchor/email-check-verify-validate

Email Check, verify and validate is an email verification tool. It helps you validate any email address online. Check if mailbox really exists ! This email validator checks email address validity in seconds. Verification of emails mainly based on servers response for most accuracy. Upload your CSV.

Anchor

936

5.0

Bulk Email Validation & Scoring

bhansalisoft/bulk-email-validation-scoring

Bulk Email Validation & Scoring-Validate Email Address List will increase your email delivery rate. our tool will check email is valid or not with mx record and smtp provider check

bhansalisoft

127

1.0

Verificaremails Email Validator Apify

verificaremails/verificaremails-email-validator-apify

Validate email addresses via VerificarEmails.com. Detect invalid, temporary, or risky emails in real time. Improve deliverability and automate contact verification in your workflows.

Verificaremails.com

Email Verifier & Deliverability Checker

yasir-on-apify/email-verifier-deliverability-checker

Verify and Validate Email Addresses with Spamtrap & Disposable Detection, SMTP Connectivity, Syntax Validation, Inbox Deliverability Check, Quality Scoring, Catch-all & Role-based Filtering, Inbox Full Status and Free Email Flagging. Optimize your email list for outreach and marketing campaigns.

Yasir

(New) Email Address Validator

overpowered/verify-email-per-month

Fast & Accurate Email Address Validator.

blg

3.8

Email Verifier

devil_port369-owner/email-verifier

Verify emails with this Apify actor: get meta info like full name, domain, and deliverability status. Input bulk emails, receive detailed JSON output. Fast, accurate email validation.

DataFusionX

420

2.4

Email Validator

louisdeconinck/email-validator

Validate emails with checks on format, alias, DNS & disposable email. Clean lists, prevent fraud and boost deliverability with this fast and easy actor.

Louis Deconinck

129

5.0

Catchall Email Verification (Source of truth, + discounts)

Catchall Email Verification (Source of truth, + discounts)

.actor/actor.json

.actor/dataset_schema.json

.actor/input_schema.json

src/__init__.py

src/__main__.py

src/main.py

src/py.typed

.dockerignore

.gitignore

Dockerfile

requirements.txt

You might also like

Email Verifier

Email Validator Pro 📧

Microsoft Catch-All Email Verifier

Email check, verify, validate

Bulk Email Validation & Scoring

Verificaremails Email Validator Apify

Email Verifier & Deliverability Checker

(New) Email Address Validator

Email Verifier

Email Validator

.actor/actor.json

.actor/dataset_schema.json

.actor/input_schema.json

src/__init__.py

src/__main__.py

src/main.py

src/py.typed

.dockerignore

.gitignore

Dockerfile

requirements.txt

src/init.py

src/main.py

src/init.py

src/main.py