emailval-client

Python client for emailval.net — email validation API.

$0.0008 per email. 10× cheaper than ZeroBounce.

Installation

pip install emailval-client

Requires Python 3.10+. The only dependency is httpx.

Quickstart

from emailval import EmailValidator

ev = EmailValidator(api_key="your_api_key")
results = ev.validate(["user@company.com", "test@mailinator.com", "bad-address"])

for r in results:
    print(r.email, r.score, r.is_valid)

Output:

user@company.com  100  True
test@mailinator.com  20  False
bad-address  0  False

Get your API key at emailval.net — self-serve, no sales call.

Five-layer validation pipeline

Every email passes through five layers:

Returns a deliverability score from 0 to 100:

result.is_valid returns True for score ≥ 60 — this threshold covers Gmail and Outlook addresses, which always return 60 because those providers block SMTP verification by design.

Pricing comparison

No monthly fee. No minimum. Stripe charges your card at the end of each billing period for exactly what you used.

Usage

Filter valid emails from a list

from emailval import EmailValidator

ev = EmailValidator(api_key="your_api_key")
results = ev.validate(your_list)

valid_emails = [r.email for r in results if r.is_valid]
print(f"{len(valid_emails)} / {len(your_list)} are valid")

Get full metadata per email

for r in results:
    print(r.email)
    print(f"  score:         {r.score}")
    print(f"  valid_syntax:  {r.valid_syntax}")
    print(f"  has_mx:        {r.has_mx}")
    print(f"  is_disposable: {r.is_disposable}")
    print(f"  is_catch_all:  {r.is_catch_all}")
    print(f"  smtp_result:   {r.smtp_result}")

Large lists (auto-batched)

Lists of any size are split into batches of 500 automatically:

ev = EmailValidator(api_key="your_api_key")
results = ev.validate(your_million_email_list)  # sends 2000 API calls

Batch response with metadata

resp = ev.validate_batch(emails[:500])   # max 500 per call
print(resp.processed)     # 500
print(resp.valid_count)   # e.g. 412
print(resp.invalid_count) # e.g. 88
print(resp.duration_ms)   # e.g. 1243

# Filter helpers
valid   = resp.valid()    # list[EmailResult] with score >= 60
invalid = resp.invalid()  # list[EmailResult] with score < 60

Skip SMTP for faster results (layers 1–3 only)

# Global — all calls skip SMTP
ev = EmailValidator(api_key="your_api_key", skip_smtp=True)

# Per-call override
results = ev.validate(emails, skip_smtp=True)

Useful when you need instant syntax + MX + disposable checks and don't need SMTP confirmation.

Async client (FastAPI, asyncio)

import asyncio
from emailval import AsyncEmailValidator

async def main():
    async with AsyncEmailValidator(api_key="your_api_key") as ev:
        results = await ev.validate(["user@example.com"])
        for r in results:
            print(r.email, r.score)

asyncio.run(main())

FastAPI middleware example

from fastapi import FastAPI
from emailval import AsyncEmailValidator

app = FastAPI()
ev  = AsyncEmailValidator(api_key="your_api_key")

@app.post("/signup")
async def signup(email: str):
    results = await ev.validate([email])
    if not results[0].is_valid:
        return {"error": "Invalid email address"}
    # ... continue signup

Error handling

from emailval import EmailValidator
from emailval.exceptions import AuthenticationError, RateLimitError, APIError

ev = EmailValidator(api_key="your_api_key")

try:
    results = ev.validate(["user@example.com"])
except AuthenticationError:
    print("Invalid API key — check emailval.net for your key")
except RateLimitError:
    print("Slow down — too many requests")
except APIError as e:
    print(f"API error {e.status_code}: {e}")

Benchmark

Validating 10,000 emails with SMTP (layers 1–5):

Total:      ~45 seconds  (20 concurrent batches of 500)
Cost:       $8.00
ZeroBounce: $80.00 for the same list

Validating 10,000 emails without SMTP (layers 1–3, skip_smtp=True):

Total:      ~3 seconds
Cost:       $8.00  (same price — charged per email regardless)

API reference

EmailValidator(api_key, base_url, timeout, skip_smtp)

ev.validate(emails, *, skip_smtp=None) → list[EmailResult]

Validate any number of emails. Large lists are split automatically.

ev.validate_batch(emails, *, skip_smtp=None) → ValidationResponse

Validate up to 500 emails. Returns metadata (duration, counts). Raises BatchTooLargeError for lists > 500.

EmailResult fields

License

MIT. See LICENSE.

Links

• Website: emailval.net
• API docs: emailval.net/#api
• Issues: github.com/DmytroMosnenko/emailval-client/issues