Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Whois querying and parsing of domain registration information.

Project Description


  • Create a simple importable Python module which will produce parsed WHOIS data for a given domain.
  • Able to extract data for all the popular TLDs (com, org, net, …)
  • Query a WHOIS server directly instead of going through an intermediate web service like many others do.
  • Works with Python 2 & 3


>>> import whois
>>> w = whois.whois('')
>>> w.expiration_date  # dates converted to datetime object
datetime.datetime(2013, 6, 26, 0, 0)
>>> w.text  # the content downloaded from whois server
u'\nWhois Server Version 2.0\n\nDomain names in the .com and .net

>>> print w  # print values of all found attributes
creation_date: 2004-06-26 00:00:00
emails: [u'', u'']
expiration_date: 2013-06-26 00:00:00


Install from pypi:

pip install python-whois

Or checkout latest version from repository:

hg clone

Note that then you will need to manually install the futures module, which allows supporting both Python 2 & 3:

pip install futures


0.6 - 2016-03-02:

  • support added for python 3
  • updated TLD list

0.5 - 2015-09-05:

  • added native client, which now handles whois requests by default
  • added pretty formatting to string representation
  • return None instead of raising KeyError when an attribute does not exist
  • new TLD’s: .mobi, .io, .kg, .su, .biz

0.4 - 2015-08-13:

  • new TLD’s: .de, .nl, .ca, .be
  • migrated to bitbucket
  • added socket timeout

0.3 - 2015-03-31:

  • improved datetime parsing with python-dateutil when available
  • base WhoisEntry class inherits from dict
  • fixed TLD’s: .org, .info


You can post ideas or patches here:

Thanks to the many who have sent patches for additional domains!

Release History

Release History

This version
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
python-whois-0.6.3.tar.gz (20.3 kB) Copy SHA256 Checksum SHA256 Source Aug 31, 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