neverbounce 0.1.3

API library for the NeverBounce email verification service.

Python API wrapper library for the NeverBounce email verification service.

Installation

$ pip install neverbounce

The only dependency is the requests library.

Usage

Sign up to get an API username and key and 1000 free monthly verifications. The free account supports only single verifications.

Single verification

>>> from neverbounce import NeverBounce

>>> neverbounce = NeverBounce('my_api_username', 'my_api_key')
>>> verified_email = neverbounce.verify('[e-mail]')

>>> verified_email.result_text
'valid'

>>> verified_email.result_code
0

>>> verified_email.is_valid
True

>>> str(verified_email)
'[e-mail]: valid'

Bulk verification

To use this features you need to configure a payment method in NeverBounce account settings.

>>> from neverbounce import NeverBounce
>>> neverbounce = NeverBounce('my_api_username', 'my_api_key')

Create the job and get it’s id:

>>> emails = ['[e-mail]', '[e-mail]']
>>> job_id = neverbounce.create_job(emails).job_id

Periodically poll for the verification job result:

>>> job_status = neverbounce.check_job(job_id)

Retrieve the result when the job is completed:

>>> if job_status.is_completed:
>>>     verified_emails = neverbounce.retrieve_job(job_id)
>>>     for email in verified_emails:
>>>         print(str(email))
'[e-mail]: valid'
'[e-mail]: invalid'

Documentation

• Official docs for the NeverBounce RESTful API

Build status