Skip to main content

ZeroBounce Python API - https://www.zerobounce.net.

Project description

Build Status

zerobounce-python-api-v2

ZeroBounce Python API v2. The response object allows an attribute-like style access.

from zerobounce import ZeroBounceAPI

zba = ZeroBounceAPI('yourapikey____________')
print zba.get_credits()
resp1 = zba.validate('flowerjill@aol.com','123.145.124.12')

print resp1
{
 "address":"flowerjill@aol.com",
 "status":"valid",
 "sub_status":"",
 "free_email":True,
 "did_you_mean":None,
 "account":"flowerjill",
 "domain":"aol.com",
 "domain_age_days": "8426",
 "smtp_provider":"yahoo",
 "mx_record":"mx-aol.mail.gm0.yahoodns.net",
 "mx_found": True,
 "firstname":"Jill",
 "lastname":"Stein",
 "gender":"female",
 "country":"United States",
 "region":"Florida",
 "city":"West Palm Beach",
 "zipcode":"33401",
 "processed_at":"2017-04-01 02:48:02.592"
}

print resp.firstname
Jill

print resp2.status
valid

Properties and possible values returned by:

  1. validate method
Property Possible Values
address The email address you are validating.
status valid /invalid /catch-all /unknown /spamtrap /abuse /do_not_mail
sub_status antispam_system /greylisted /mail_server_temporary_error /forcible_disconnect /mail_server_did_not_respond /timeout_exceeded /failed_smtp_connection /mailbox_quota_exceeded /exception_occurred /possible_traps /role_based /global_suppression /mailbox_not_found /no_dns_entries /failed_syntax_check /possible_typo /unroutable_ip_address /leading_period_removed /does_not_accept_mail /role_based_catch_all /disposable /toxic
account The portion of the email address before the "@" symbol.
domain The portion of the email address after the "@" symbol.
did_you_mean Suggestive Fix for an email typo.
domain_age_days Age of the email domain in days or [None].
free_email [True/False] If the email comes from a free provider.
mx_found [True/False] Does the domain have an MX record.
mx_record The preferred MX record of the domain
smtp_provider The SMTP Provider of the email or [None] (BETA).
firstname The first name of the owner of the email when available or [None].
lastname The last name of the owner of the email when available or [None].
gender The gender of the owner of the email when available or [None].
country The country the email signed up when ip address is provided or [None].
region The region the email signed up when ip address is provided or [None].
city The city the email signed up when ip address is provided or [None].
zipcode The zipcode the email signed up when ip address is provided or [None].
processed_at The UTC time the email was validated.
  1. get_credits method
Property Possible Values
credits The number of credits left in account for email validation.

Any of the following email addresses can be used for testing the API, no credits are charged for these test email addresses:

You can this IP to test the GEO Location in the API.

  • 99.110.204.1

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sl-zerobounce-0.1.4.tar.gz (4.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page