Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sublime-security/emailrep.io
emailrep.io Public API
https://github.com/sublime-security/emailrep.io
emailrep fraud-detection phishing phishing-detection reputation spam
Last synced: 3 months ago
JSON representation
emailrep.io Public API
- Host: GitHub
- URL: https://github.com/sublime-security/emailrep.io
- Owner: sublime-security
- Created: 2019-04-09T00:23:34.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-16T04:28:59.000Z (8 months ago)
- Last Synced: 2024-06-17T20:01:23.147Z (5 months ago)
- Topics: emailrep, fraud-detection, phishing, phishing-detection, reputation, spam
- Homepage: https://emailrep.io
- Size: 19.5 KB
- Stars: 284
- Watchers: 15
- Forks: 31
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starz - sublime-security/emailrep.io - emailrep.io Public API (Others)
README
EmailRep Alpha Risk API
==========
by [Sublime Security](https://sublimesecurity.com)
## Overview
EmailRep is a system of crawlers, scanners and enrichment services that collects data on email addresses, domains, and internet personas.
EmailRep uses hundreds of data points from social media profiles, professional networking sites, dark web credential leaks, data breaches, phishing kits, phishing emails, spam lists, open mail relays, spam traps, domain age and reputation, deliverability, and more to predict the risk of an email address and answer these types of questions:
* Is this email risky?
* Is this a throwaway account?
* Is there potential for this signup to commit fraud or abuse?
* What kind of online presence does this email have?
* Is this a trustworthy sender?
## URL
```
https://emailrep.io
```
## Libraries
* [Python](https://github.com/sublime-security/emailrep.io-python)
* [PowerShell](https://github.com/arnydo/PSEmailRep)
* [R](https://git.rud.is/hrbrmstr/emailrep)
* [.NET](https://github.com/WestDiscGolf/EmailRep.NET)
* [Go](https://github.com/kaiiyer/emailrep)
* [Go](https://github.com/vertoforce/go-emailrep)
## Detailed Usage
For authentication info, code samples, and reporting malicious email addresses see our [detailed documentation](https://docs.emailrep.io).
## Simple Usage
### `GET` /[email] - query an email
Example:
```
$ curl -s emailrep.io/[email protected]
{
"email": "[email protected]",
"reputation": "high",
"suspicious": false,
"references": 79,
"details": {
"blacklisted": false,
"malicious_activity": false,
"malicious_activity_recent": false,
"credentials_leaked": true,
"credentials_leaked_recent": false,
"data_breach": true,
"first_seen": "07/01/2008",
"last_seen": "05/24/2019",
"domain_exists": true,
"domain_reputation": "high",
"new_domain": false,
"days_since_domain_creation": 10341,
"suspicious_tld": false,
"spam": false,
"free_provider": false,
"disposable": false,
"deliverable": true,
"accept_all": true,
"valid_mx": true,
"spoofable": false,
"spf_strict": true,
"dmarc_enforced": true,
"profiles": [
"myspace",
"spotify",
"twitter",
"pinterest",
"flickr",
"linkedin",
"vimeo",
"angellist"
]
}
}
```
## Response Details
* `reputation`: high/medium/low/none
* `suspicious`: whether the email address should be treated as suspicious or risky
* `references`: total number of positive and negative sources of reputation. note that these may not all be direct references to the email address, but can include reputation sources for the domain or other related information
* `blacklisted`: the email is believed to be malicious or spammy
* `malicious_activity`: the email has exhibited malicious behavior (e.g. phishing or fraud)
* `malicious_activity_recent`: malicious behavior in the last 90 days (e.g. in the case of temporal account takeovers)
* `credentials_leaked`: credentials were leaked at some point in time (e.g. a data breach, pastebin, dark web, etc.)
* `credentials_leaked_recent`: credentials were leaked in the last 90 days
* `data_breach`: the email was in a data breach at some point in time
* `first_seen`: the first date the email was observed in a breach, credential leak, or exhibiting malicious or spammy behavior ('never' if never seen)
* `last_seen`: the last date the email was observed in a breach, credential leak, or exhibiting malicious or spammy behavior ('never' if never seen)
* `domain_exists`: valid domain
* `domain_reputation`: high/medium/low/n/a (n/a if the domain is a free_provider, disposable, or doesn't exist)
* `new_domain`: the domain was created within the last year
* `days_since_domain_creation`: days since the domain was created
* `suspicious_tld`: suspicious tld
* `spam`: the email has exhibited spammy behavior (e.g. spam traps, login form abuse)
* `free_provider`: the email uses a free email provider
* `disposable`: the email uses a temporary/disposable service
* `deliverable`: deliverable
* `accept_all`: whether the mail server has a default accept all policy. some mail servers return inconsistent responses, so we may default to an accept_all for those to be safe
* `valid_mx`: has an MX record
* `spoofable`: email address can be spoofed (e.g. not a strict SPF policy or DMARC is not enforced)
* `spf_strict`: sufficiently strict SPF record to prevent spoofing
* `dmarc_enforced`: DMARC is configured correctly and enforced
* `profiles`: online profiles used by the email
## Use cases
Defensive:
* Detect targeted phishing attacks.
* Detect and prevent fraud.
* Detect throwaway accounts.
* Require additional layers of verification (MFA) during your signup flow to prevent abuse.
* Contextualize netflow and other products that analyze email addresses or related data.
Offensive (ethical):
* Conduct recon on a target email address for credential brute forcing.
* Construct targeted phishing attacks based off of target's social media profiles.
* Inform reputation of social engineering campaigns (higher reputation can help avoid the spam folder).