Official Library

Python Email Verification SDK

The official Python SDK for EmailVerify.io. Build robust, failure-resilient applications with native async support and comprehensive domain infrastructure analysis tools.

Free plan available. No credit card required.

sdk-example.worker

Quick Installation

Install the Official EmailVerify Python SDK using pip.

terminal
$ pip install emailverifysdk

Usage Examples

1 Real-time Email Validation

Perform instant SMTP handshake verification. Our Python library connects directly to our high-speed global network to verify mailbox existence without sending actual emails.

python
from emailverifysdk import Client

client = Client("your_api_key")
result = client.verify("[email protected]")

if result.is_valid:
    print(f"Email is safe to send! Score: {result.score}")
else:
    print(f"Danger: {result.reason}")

2 High-Throughput Batch Processing

Handle millions of emails efficiently. The batch endpoint allows you to offload heavy verification tasks to our cloud workers. Use polling or webhooks to retrieve results asynchronously.

python
emails =["[email protected]", "[email protected]", ...]
batch_id = client.create_batch(emails)

# Later or poll
status = client.get_batch_status(batch_id)
if status.completed:
    results = client.get_batch_results(batch_id)
    print(f"Processed {len(results)} emails successfully.")

3 Advanced Client Configuration

Fine-tune the library for mission-critical applications. Set custom timeouts, automatic retry logic, and SSL verification settings to match your enterprise security requirements.

python
client = Client(
    api_key="your_api_key",
    timeout=30.0,       # Custom second timeout
    max_retries=3,      # Automatic retry on network glitch
    verify_ssl=True     # Ensure secure connections
)

4 Intelligent Email Finder

Generate verified leads with high confidence. Our Finder API uses advanced heuristics and historical data to predict and verify professional email addresses based on name and domain.

python
profile = client.find_email(
    first_name="Jane",
    last_name="Smith",
    domain="acme-corp.com"
)

if profile.email:
    print(f"Found verified email: {profile.email}")
    print(f"Confidence: {profile.confidence}%")

5 Syntax & Domain Health Check

Stop bad data at the source. Validate RFC compliance and provide real-time typo corrections (like gmial.com to gmail.com) to improve user experience on your sign-up forms.

python
check = client.check_syntax("malformed@@email.com")
print(f"Syntax Valid: {check.is_syntax_valid}")
print(f"Correction Suggestion: {check.suggestion}") # e.g. @gmial.com -> @gmail.com

6 Robust Error Handling

Build resilient applications. Our library provides specific exception classes for rate limits, authentication failures, and network timeouts, allowing you to implement graceful degradation.

python
try:
    result = client.verify("[email protected]")
except client.RateLimitError:
    print("Backing off... Please upgrade your plan.")
except client.AuthenticationError:
    print("Check your API key.")
except Exception as e:
    print(f"Network error: {e}")

7 Asynchronous Support (Asyncio)

Optimized for modern web frameworks. Switch to our AsyncClient for use with FastAPI, Sanic, or Django Channels to manage high-concurrency verification tasks without blocking your event loop.

python
import asyncio
from emailverifysdk.async_client import AsyncClient

async def main():
    async with AsyncClient("api_key") as client:
        result = await client.verify("[email protected]")
        print(result.status)

asyncio.run(main())

8 MX & Infrastructure Analysis

Deep-dive into recipient infrastructure. Detect if a domain is using a disposable mail provider, a catch-all configuration, or professional ESPs like Google Workspace or Microsoft 365.

python
info = client.get_domain_info("google.com")
print(f"Provider: {info.provider}") # e.g. Google Workspace
print(f"Accepts All: {info.is_catch_all}")
print(f"Is Disposable: {info.is_disposable}")
FAQs

Frequently Asked Questions

Question Icon

Is an API key required to use the Python SDK?

Yes, you need a valid API key from your EmailVerify.io dashboard. You can sign up for a free account to get your key instantly.

Question Icon

How accurate are the Python SDK results?

Our Python SDK provides 99%+ accuracy by using real-time SMTP handshake checks and advanced disposable email detection.

Question Icon

Can I use the Python SDK in asynchronous applications?

Yes, the SDK is lightweight and can be easily used within asynchronous frameworks like FastAPI or with libraries like asyncio.

Question Icon

Does the Python SDK support batch verification?

Yes, it includes a validate_batch method for processing large lists of emails efficiently in the background.

You're just one click away from clean email lists.

Start verifying your email addresses instantly and improve your campaign deliverability

* No credit card required