addrly 1.0.0

Official Python SDK for the Addrly email validation API

addrly

Official Python SDK for the Addrly email validation API.

Install

pip install addrly

Quick Start

from addrly import Addrly

client = Addrly("sk_your_api_key")

# Validate an email
result = client.validate_email("[e-mail]")
print(result["mx"], result["disposable"], result["domain_age_in_days"])

# Validate a domain
domain = client.validate_domain("example.com")

# Auto-detect (email or domain)
auto = client.validate("[e-mail]")

Bulk Validation

# Bulk email validation (Pro: 500, Ultra: 1000)
bulk = client.bulk_validate_emails([
    "[e-mail]",
    "[e-mail]",
    "[e-mail]",
])
print(bulk["summary"])  # {"total": 3, "valid": 2, ...}

# Bulk domain validation
domains = client.bulk_validate_domains(["gmail.com", "tempmail.com"])

Gates

# Evaluate an email against a gate
decision = client.gate("gate_abc123def456", email="[e-mail]")
print(decision["decision"]["action"])  # "block"

Error Handling

from addrly import Addrly, AddrlyError

try:
    result = client.validate_email("[e-mail]")
except AddrlyError as e:
    print(e.status)    # 429
    print(e.error)     # "Rate limit exceeded"
    print(e.response)  # full API error response