The Python database reader allows your Python application to use the on-premise IPQS email verification database and make informed decisions about email addresses.
- Proxy & VPN Detection API
- Email Verification API
- Phone Number Validation API
- Device Fingerprint API
- Malicious URL Scanner API
- Mobile Device Fingerprinting SDK
- Gaming Fraud Detection SDK
- Dark Web Leak API
- Malware File Scanner API
- Request List API
- Fraud Reporting API
- Account Management APIs
- Bulk Validation CSV API
- Allowlist & Blocklist APIs
- Plugins Platforms & Integrations
- IP Reputation Database
- Email Verification Database
- Custom Integrations
- Country List API
Python Database Reader
About the Python Database Reader
Installation
You can easily install the Python database reader using pip :
pip install git+https://github.com/IPQualityScore/PythonIPQSEmailDBReader
Usage
The following example shows how you can use the Python database reader in your application to retrieve data about a specific email address:
1
from util.emaillookup.emaillookup import EmailLookup2
emailLookup = EmailLookup(path="path/to/bin")3
results = lookup.lookupEmail("test@email.com")4
print(results)Fields
Some of these fields may be unavailable depending on which database file you receive. If the field in question is unavailable in your database, the method will default to Pythons's default value for that type.
| Field | Type | Description |
| record.valid() | bool | Does this email address appear valid? |
| record.disposable() | bool | Is this email suspected of belonging to a temporary or disposable mail service? Usually associated with fraudsters and scammers. |
| record.smtpScore() | int | Validity score of email server's SMTP setup. Range: "0" to "3". 0x00 = mail server exists, but is rejecting all mail 0x01 = mail server exists, but is showing a temporary error 0x02 = mail server exists, but accepts all email 0x03 = mail server exists and has verified the email address |
| record.suspect() | bool | This value indicates if the mail server is currently replying with a temporary mail server error or if the email verification system is unable to verify the email address due to a broken SMTP handshake. This status will also be true for "catch all" email addresses as defined below. If this value is true, then we suspect the "valid" result may be tainted and there is not a guarantee that the email address is truly valid. This status is rarely true for popular mailbox providers and typically only returns as true for a small percentage of business mail servers. |
| record.catchAll() | bool | Is this email likely to be a "catch all" where the mail server verifies all emails tested against it as valid? It is difficult to determine if the address is truly valid in these scenarios, since the email's server will not confirm the account's status. |
| record.deliverability() | int | How likely is this email to be delivered to the user and land in their mailbox. Values can be "high", "medium", "low" or "none". 0x00 = none 0x01 = low 0x02 = medium 0x03 = high |
| record.fraudScore() | int | The overall Fraud Score of the user based on the email's verification and recent behavior across the IPQS threat network. Fraud Scores >= 75 are suspicious, but not necessarily fraudulent. |
| record.leaked() | bool | Was this email address associated with a recent database leak from a third party? Leaked accounts pose a risk as they may have become compromised during a database breach. |
| record.recentAbuse() | bool | This value will indicate if there has been any recently verified abuse across our network for this email address. Abuse could be a confirmed chargeback, fake signup, compromised device, fake app install, or similar malicious behavior within the past few days. |
| record.userVelocity() | bool | Frequency at which this email address makes legitimate purchases, account registrations, and engages in legitimate user behavior online. Values can be "high", "medium", "low", or "none". Values of "high" or "medium" are strong signals of healthy usage. New email addresses without a history of legitimate behavior will have a value as "none". This field is restricted to higher plan tiers. |
| record.firstSeen() | time.Time | When this email address was first seen online. |
| record.domainAge() | time.Time | Date when this domain was registered. |
| record.domainCommon() | bool | Is this email from common free email providers? ("gmail.com", "yahoo.com", "hotmail.com", etc.) |
| record.domainVelocity() | bool | Indicates the level of legitimate users interacting with the email address domain. Values can be "high", "medium", "low", or "none". Domains like "IBM.com", "Microsoft.com", "Gmail.com", etc. will have "high" scores as this value represents popular domains. New domains or domains that are not frequently visited by legitimate users will have a value as "none". This field is restricted to upgraded plans. |
| record.domainDisposable() | bool | Is this domain suspected of belonging to a temporary or disposable mail service? Usually associated with fraudsters and scammers. |