import requests

# Verify deliverability of a single email
resp = requests.get(
    "https://api.minelead.io/v1/validate/",
    params={"key": "YOUR_API_KEY", "email": "john@stripe.com"}
)
data = resp.json()
# {"status": "success", "form": true,
#  "mx": true, "exist": true, "personal": false}

print('Status  :', data.get('status'))  # success | catch-all | error
print('MX ok   :', data.get('mx'))     # True | False
print('Exists  :', data.get('exist'))  # True | False | "unknown"
print('Webmail :', data.get('personal'))# True | False

import requests

# Enrich a contact from their email
resp = requests.get(
    "https://api.minelead.io/v1/enrich/",
    params={"key": "YOUR_API_KEY", "email": "john@stripe.com"}
)
data = resp.json()
# {"status": "success", "name": "John Smith",
#  "role": "VP of Engineering",
#  "company_full": "Stripe, Inc.",
#  "location": "San Francisco, CA"}

print(f"{data['name']} — {data['role']}")
print(f"{data['company_full']}, {data['location']}")
# John Smith — VP of Engineering
# Stripe, Inc., San Francisco, CA

import requests

# Detect buying intent signals for a company
resp = requests.get(
    "https://api.minelead.io/v1/buying-intent/",
    params={
        "key":     "YOUR_API_KEY",
        "company": "Stripe",
        "domain":  "stripe.com",
    }
)
data = resp.json()
# {"status": "success", "intent_level": "hot",
#  "intent_score": 80, "confidence": "high"}

print('Level :', data['intent_level'])  # hot / warm / cold / none
print('Score :', data['intent_score'])  # 0–100

import requests

# Find emails from a Twitter/X or YouTube URL
resp = requests.get(
    "https://api.minelead.io/v1/social-email-finder/",
    params={
        "key": "YOUR_API_KEY",
        "url": "https://www.youtube.com/@mkbhd",
    }
)
data = resp.json()
# {"status": "found", "platform": "youtube",
#  "channel_name": "Marques Brownlee", "domains": [...]}

for grp in data.get('domains', []):
    for e in grp['emails']:
        print(f"✓ {e['email']}  quality={e['quality']}")
# ✓ marques@mkbhd.com  quality=92

import requests

# Check if an email is disposable
resp = requests.get(
    "https://api.minelead.io/v1/detect-disposable/",
    params={"key": "YOUR_API_KEY", "email": "user@tempmail.com"}
)
data = resp.json()
# {"status": "success", "email": "user@tempmail.com",
#  "disposable_status": "Disposable",
#  "mx_record_status": "Present"}

if data['disposable_status'] == 'Disposable':
    raise ValueError('Disposable emails are not allowed.')
# ValueError: Disposable emails are not allowed.