Skip to content
View TempCatcher's full-sized avatar

Block or report TempCatcher

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
tempcatcher/README.md

TempCatcher, identify spam emails on clean domains.

What is TempCatcher?

TempCatcher is a service which provides intelligence on temporary email addresses.

Why use TempCatcher?

Our service is the logical next step If you have exhausted all other solutions in your battle against spam (domain white-listing / blacklisting).

How do i use TempCatcher?

Please refer to quick start guide

Where do you get your data?

We aggregate our data from a variety of known spam providers.

Do you offer any paid services?

Yes, we offer a more simple "checks" api which allows you to send an email via http(s) and check if that is in our database.

For enterprise customers also provide intelligence on phone numbers as well.

if you are interested in these services please email [email protected]


Quick Start guide

1) Install TempCatcher api.

pip install tempcatcher

2) Example code:

from tempcatcher import *
t = TempCatcher()

email, status = t.check(input("Input email you would like to check: "), dns = True)

match status:
    case 0:
        print(f"Email: `{email}` was found in the tempcatcher data. (spam)")
    case 1:
        print(f"Email: `{email}` was not found in the tempcatcher data. (not spam)")
    case 2:
        print(f"Email was formatted incorrectly.")
    case 3:
        print(f"Email: `{email}` Could not find DNS MX record assocciated with domain")
    case _:
        print(f"How did we get here?")
del t # join update thread

3) Known Issues.

On windows / NT you may get a UnicodeDecodeError when trying to import tempcatcher,

the quickest solution is to add -X utf8 to your command arguments,

but here is a link to more in-depth analysis / help.

Popular repositories Loading

  1. tempcatcher tempcatcher Public

    TempCatcher, identify spam emails on clean domains.

    Python 1