Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Client for Email Hunter REST API

Project Description



  • Python 3 (because it’s 2015)

To install:

pip install email-hunter-python

To update:

pip install --upgrade email-hunter-python


email_hunter_python supports the three main methods of the Email Hunter API: search, generate, and exist. There are two ways to use email_hunter_python:

  • As a Python library
  • As a command line (CLI) tool.

To use the email_hunter_python Python library:

Import the client and instantiate it:

from email_hunter import EmailHunterClient
client = EmailHunterClient('my_api_key')

You can search:'')

A max of 100 results are returned, so use offset to paginate:'', offset=1)

You can also change type (personal or generic):'', type='personal')

You can generate:

client.generate('', 'Sergey', 'Brin')

And you can check if an email exists:


To use email_hunter_python as a CLI tool:

email_hunter [command name] [api_key] [other args]

The command name is search, generate or exist, the api_key is the API key associated with your Email Hunter account

The other arguments depend on the command you are using:

--domain       Required for search and generate commands
--offset       Optional, used with search command.
--type         Optional, used with search command
--first_name   Required for generate command
--last_name    Required for generate command
--email        Required for exist command
--file         Path to a CSV to be used with the specified command.
               CSV must have a column for each argument used.

The file argument is useful when you want to make several requests of the same type. For example if you wanted to find the email addresses for several people at an organization you would do the following:

email_hunter generate [api_key] --file people.csv > emails.csv

Where people.csv looks like:


The output will also be in a CSV format.


Copyright © 2015 Alan Vezina

Released under The MIT License (MIT), see the LICENSE file for details

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
email_hunter_python-1.1.0.tar.gz (5.0 kB) Copy SHA256 Checksum SHA256 Source Jul 5, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting