gitwtfhub

wtf is tempmail-unofficialapi?

josskixg/tempmail-unofficialapi — explained in plain English

Analysis updated 2026-05-18

19JavaAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A multi-language library (Go, Python, Java, PHP, JavaScript, Rust, C#) that programmatically generates and manages disposable email addresses across 16 tempmail services.

Mindmap

mindmap
  root((TempMail-UnofficialAPI))
    What it does
      Generate disposable emails
      Poll inbox
      Read and delete messages
    Tech stack
      Go
      Python
      Java
      JavaScript
      Rust
      PHP
      C sharp
    Use cases
      Test automation
      Signup flows
      Bulk provider switching
    Caveats
      Unofficial wrappers
      Endpoints may change
      No spam or fraud use

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Programmatically generate a disposable email address and poll its inbox from Go, Python, Java, PHP, JavaScript, Rust, or C#.

REASON 2

Automate account signups or testing flows that require a real, receivable but throwaway email address.

REASON 3

Swap between 16 different tempmail providers behind one consistent API without rewriting integration code.

What's in the stack?

JavaGoPythonJavaScriptRustPHPC#

How it stacks up

josskixg/tempmail-unofficialapicheburnetik/autoconnector_for_telegramgetactivity/easypermissions
Stars191919
LanguageJavaJavaJava
Last pushed2026-01-10
MaintenanceQuiet
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Install the package for your language (pip, npm, cargo, Maven, NuGet) and follow that folder's own README.

Apache 2.0: use, modify, and distribute freely, including commercially, with patent protection and required attribution.

Wtf does this do

TempMail Unofficial API is a collection of code libraries that let a program create and manage disposable email addresses automatically, instead of requiring a person to open a website and click around. The project provides the same set of features rewritten in seven programming languages: Go, Python, Java, PHP, JavaScript, Rust, and C sharp, so developers can pick whichever language matches their own project. Under the hood, each language version wraps sixteen different temporary email services, such as Mail.tm, GuerrillaMail, YOPmail, and Dropmail. Some of these services offer a proper JSON API, while others only offer a regular web page, so the library scrapes that page to get the same result. Every wrapper, regardless of language or underlying service, exposes the same handful of actions: generate a new temporary email address, fetch the messages sitting in its inbox, read the full content of one message, wait for a new message to arrive, and delete the mailbox when it's no longer needed. A received message carries the sender, subject, date, and a unique id, and reading a message additionally returns its plain text body, its HTML body if one exists, and any attachments. Because none of these sixteen services publish an official developer API, the project describes itself clearly as unofficial and not affiliated with any of them, warns that the underlying endpoints can change without notice, and asks that it only be used for testing, development, or personal automation, never for spam, fraud, or other illegal activity. The project is organized as one folder per language, each with its own installation instructions and usage examples, plus shared documentation like release notes and a changelog at the repository root. Planned future work includes more resilient scraping for sites that resist bots, real time inbox updates over WebSockets for a couple of the services, wrapper support for Kotlin, Swift, and Ruby, and a single command line tool that can manage temporary mailboxes across all the supported providers at once. The project is released under the Apache License 2.0.

Yoink these prompts

Prompt 1
Show me how to generate a temporary email, wait for a message, and read its body using the Python wrapper in TempMail-UnofficialAPI.
Prompt 2
Write a test automation script in Go that signs up for a service using a disposable email from this library and confirms the verification email.
Prompt 3
Compare the Mail.tm and Dropmail.me wrappers in this repo and tell me which one needs an auth token.
Prompt 4
Add a Kotlin wrapper to TempMail-UnofficialAPI following the existing interface: generate_email, get_inbox, read_message, delete_email.

Frequently asked questions

wtf is tempmail-unofficialapi?

A multi-language library (Go, Python, Java, PHP, JavaScript, Rust, C#) that programmatically generates and manages disposable email addresses across 16 tempmail services.

What language is tempmail-unofficialapi written in?

Mainly Java. The stack also includes Java, Go, Python.

What license does tempmail-unofficialapi use?

Apache 2.0: use, modify, and distribute freely, including commercially, with patent protection and required attribution.

How hard is tempmail-unofficialapi to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tempmail-unofficialapi for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.