verify_single.py

"""
Verify a single email address using the OrbiSearch API.
"""

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.orbisearch.com"


def verify_email(email: str, timeout: int = 70) -> dict:
    """
    Verify a single email address.

    Args:
        email: Email address to verify
        timeout: Timeout in seconds (3-90, default 70)

    Returns:
        Verification result dict
    """
    response = requests.get(
        f"{BASE_URL}/v1/verify",
        params={"email": email, "timeout": timeout},
        headers={"X-API-Key": API_KEY},
    )
    response.raise_for_status()
    return response.json()


if __name__ == "__main__":
    result = verify_email("test@example.com")

    print(f"Email: {result['email']}")
    print(f"Status: {result['status']}")
    print(f"Substatus: {result.get('substatus')}")
    print(f"Explanation: {result['explanation']}")
    print(f"Provider: {result['email_provider']}")
    print(f"Is Disposable: {result.get('is_disposable')}")
    print(f"Is Role Account: {result.get('is_role_account')}")
    print(f"Is Free: {result.get('is_free')}")