Skip to content

README.md

Latest commit

 

History

History
168 lines (128 loc) · 7 KB

README.md

File metadata and controls

168 lines (128 loc) · 7 KB
Raw

TempMail Unofficial API Wrapper

📬 TempMail Unofficial API — Multi-Language Wrappers

v1.1.0 — Released 2026-07-02  |  Release Notes  |  Changelog  |  v1.1.0 Plan

🇬🇧 English | 🇮🇩 Bahasa Indonesia | 🇨🇳 中文

Collection of unofficial wrappers for various Temporary Email services, written in 7 programming languages. One repo, one goal: programmatically create and manage disposable emails with ease.

🎯 Supported Languages

Language Folder Package Manager Status
Go /go go get ✅ Done
Python /python pip ✅ Done
Java /java Maven / Gradle ✅ Done
PHP /php Composer ✅ Done
JavaScript /javascript npm / yarn ✅ Done
Rust /rust cargo ✅ Done
C# /csharp NuGet ✅ Done

🌐 Supported TempMail Services

The library wrapper currently supports 16 temporary email services:

# Service Website API Type Auth Difficulty Status
1 Mail.tm mail.tm REST+JSON Bearer Token ✅ Easy Active
2 GuerrillaMail guerrillamail.com REST Session Token ⚡ Medium Active
3 YOPmail yopmail.com HTML Scraping None ⚡ Medium Active
4 Dropmail dropmail.me GraphQL Token (auto) ✅ Easy Active
5 1secemail 1secemail.com REST None ✅ Easy Active
6 Ncaori Mail+ nca.my.id REST+JSON None ✅ Easy Active
7 Zoromail zoromail.com REST+JSON None ✅ Easy Active
8 Tempmail.lol tempmail.lol REST+JSON Token ✅ Easy Active
9 Tempmailc tempmailc.com REST+JSON None ✅ Easy Active
10 Temp-mail.io temp-mail.io REST+JSON Bearer Token ⚡ Medium Active
11 Tempmail.plus tempmail.plus REST+JSON None ✅ Easy Active
12 Emailfake emailfake.com HTML Scraping Cookie ⚡ Medium Active
13 Generator.email generator.email HTML Scraping Cookie ⚡ Medium Active
14 Mailnesia mailnesia.com HTML Scraping None ⚡ Medium Active
15 10minutemail 10minutemail.net HTML Scraping Cookie Session ⚡ Medium Active (via 10minutemail.net)
16 Email-temp email-temp.com HTML Scraping Cookie ⚡ Medium Active

📁 Project Structure

TempMail-UnofficialAPI/
├── go/                   # Go wrapper
├── python/               # Python wrapper
├── java/                 # Java wrapper
├── php/                  # PHP wrapper
├── javascript/           # Node.js / JavaScript wrapper
├── rust/                 # Rust wrapper
├── csharp/               # C# / .NET wrapper
├── docs/
│   └── plan/
│       └── PLAN_v1.1.0.md  # v1.1.0 implementation plan
├── README.md             # English (default)
├── README.id.md          # Bahasa Indonesia
├── README.cn.md          # 中文
├── RELEASE_NOTES.md      # Per-version release notes
├── CHANGELOG.md          # Full change history
├── LICENSE               # Apache 2.0
└── NOTICE                # Attribution & disclaimer

🚀 Quick Start

Each language has its own README. Click the folder above for installation details and usage examples.

General Example (Pseudocode)

// 1. Generate a temporary email
email = tempmail.generate()
// → "random123@mail.tm"

// 2. Check inbox
messages = tempmail.get_inbox(email)

// 3. Read a message
if messages.length > 0:
    content = tempmail.read_message(messages[0].id)

// 4. Delete (optional, auto-expire works too)
tempmail.delete(email)

⚡ API Interface (All Languages)

All wrappers implement a consistent interface:

Method Description Return
generate_email() Generate a temporary email address string (email address)
get_inbox(email) Retrieve list of messages []Message
read_message(id) Read message content MessageDetail
delete_email(email) Delete email (cleanup) bool
wait_for_email(email, timeout) Poll for new messages Message or null

📦 Data Model

Message

  • id — Unique message identifier
  • from — Sender address
  • subject — Email subject
  • date — Received timestamp

MessageDetail (extends Message)

  • body_text — Plain text email body
  • body_html — HTML email body (if available)
  • attachments — List of attachment metadata

🛡️ Disclaimer

⚠️ IMPORTANT

  • This project is UNOFFICIAL — not affiliated with any tempmail service.
  • API endpoints may change at any time without notice.
  • Use for testing, development, or personal automation only.
  • Do not use for spam, fraud, or any illegal activity.
  • Some services have rate limits — use responsibly.

🤝 Contributing

Want to add a language? Fix a bug? Go ahead:

  1. Fork this repo at github.com/josskixg/TempMail-UnofficialAPI
  2. Create a branch: feat/add-kotlin-wrapper
  3. Commit & push
  4. Open a Pull Request

Contribution Guidelines

  • Follow the existing interface structure
  • Add usage examples in the per-language README
  • Never hardcode API keys (use environment variables)
  • Test before submitting a PR

🗺️ Roadmap

v1.1.0 shipped with 16 services across 7 languages. Planned for upcoming releases:

  • Improved YOPmail & Scraping resilience — anti-bot bypass improvements and headless support
  • WebSocket support for Dropmail.me and Mail.tm (real-time inbox subscription)
  • More languages — Kotlin, Swift, and Ruby wrappers
  • CLI tool — unified command-line tool to manage temporary mailboxes across all providers directly from your terminal

Contributions welcome — see CONTRIBUTING.md and open a PR or Issue.

📄 License

Apache License 2.0 — see LICENSE and NOTICE.

🌟 Star this repo if it helps your project!
Built with 🫠 by the community, for the community.