Skip to main content

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()
  1. 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
)
  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,                # Optional
    delay_between_retries=1.5       # Optional
)
  1. 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

Metadata

Release files for cybertemp 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cybertemp 0.1.3
File Size Uploaded Provenance
cybertemp-0.1.3.tar.gz 6.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for cybertemp 0.1.3
File Interpreter ABI Platform
cybertemp-0.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 12.9 kB

Release files / cybertemp-0.1.3.tar.gz

Download URL cybertemp-0.1.3.tar.gz
Size 6.3 kB
Tags Source
SHA-256 checksum
How to use checksums
aefc9dbad3164a73dff2ed8fca0db324d692065156b4cdbe5b33742399a316c8
BLAKE2b-256 checksum
How to use checksums
00ceb4e86eca953ba3e8ed565f7e1b23087a4ccaad3add60df17843a07cd860e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / cybertemp-0.1.3-py3-none-any.whl

Download URL cybertemp-0.1.3-py3-none-any.whl
Size 6.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
406cd5810a7c31945a5a899eb67819f97cec447f320ba432e30ab56d12df4aee
BLAKE2b-256 checksum
How to use checksums
144397b2afc49c615e711bbcbe7f636e2236bd5b5b80de7ae0d6d4d8420e6508
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Security for cybertemp 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page