CyberTemp API Client

A Python client for interacting with the CyberTemp temporary email service API.

🌐 Website · 📜 ChangeLog · ⚠️ Report Bug

---

Available Methods

1. Get Email Content

emails = client.get_email_content("test@cybertemp.xyz", max_retries=3, delay_between_retries=2.0)

1. Get Email by ID

email = client.get_email_content_by_id("test@cybertemp.xyz", "email_id_here")

1. Get Available Domains

domains = client.get_domains()

1. Search Email by Subject

mail_id = client.get_mail_by_subject(
    email="test@cybertemp.xyz",
    subject_contains="Verification",
    max_attempts=5,
    delay_between_retries=1.5
)

1. Extract URL from Email

url = client.extract_url_from_message(
    email="test@cybertemp.xyz",
    subject_contains="Verification",
    url_pattern=r'https://[^\s<>"']+',
    max_attempts=5,
    delay_between_retries=1.5
)

1. Get Plan Info

plan = client.get_plan()

1. Delete Email

success = client.delete_email("email_id_here")

1. Delete Inbox (Deprecated - use delete_user_inbox instead)

# This method now calls delete_user_inbox internally
success = client.delete_inbox("test@cybertemp.xyz")

1. List User Inboxes

inboxes = client.list_user_inboxes()

1. Delete User Inbox

success = client.delete_user_inbox("test@cybertemp.xyz")

1. Get Private Emails (Bearer Token)

private_emails = client.get_private_emails(bearer_token="your_bearer_token", email="test@cybertemp.xyz")

1. Check API Health

health = client.get_health()
# Returns: {"status": "ok"} on success
# Returns: {"error": "API unavailable", "reason": "..."} on error

1. **Get Available Domains**

```py
domains = client.get_domains()

4. Search Email by Subject

mail_id = client.get_mail_by_subject(
    email="test@cybertemp.xyz",
    subject_contains="Verification",
    max_attempts=5,                # Optional
    delay_between_retries=1.5       # Optional
)

5. Extract URL from Email

url = client.extract_url_from_message(
    email="test@cybertemp.xyz",
    subject_contains="Verification",
    url_pattern=r"""https://[^\s<>"']+""",
    max_attempts=5,                # Optional
    delay_between_retries=1.5       # Optional
)

6. Check API Balance

balance = client.get_balance()

💳 Pricing & Plans

CyberTemp offers several subscription plans:

• Free Tier: No API key required, 2-second delay, 10 req/sec
• Eco Plan: €1.99/month, no delay, 20 req/sec
• Core Plan: €2.99/month, no delay, 50 req/sec
• Elite Plan: €4.99/month, no delay, unlimited requests

All paid plans require an API key. See CyberTemp Pricing for details and to purchase a key.

⚠️ Rate Limits

• All requests require an API key (except Free tier)
• Free tier: 2-second delay between requests, 10 req/sec
• Paid tiers: No delay, higher rate limits

📜 ChangeLog

v0.1.0 ⋮ 2025-12-10
+ Added get_health() method for API health checks
! Fixed delete_inbox() - now correctly uses /api/user/inboxes endpoint
! Updated all API endpoints to use consistent base URL (api.cybertemp.xyz)
! Deprecated delete_inbox() - now calls delete_user_inbox() internally

v0.0.9 ⋮ 2025-03-05
+ Added configurable retry and delay options for email checking functions
+ Indicated optional parameters in documentation

v0.0.1 ⋮ 2025-02-14
! Initial release