Skip to main content

Whois querying and parsing of domain registration information.

Project description

Goal

  • 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

Example

>>> import whois
>>> w = whois.whois('webscraping.com')
>>> 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
domain_name: [u'WEBSCRAPING.COM', u'WEBSCRAPING.COM']
emails: [u'WEBSCRAPING.COM@domainsbyproxy.com', u'WEBSCRAPING.COM@domainsbyproxy.com']
expiration_date: 2013-06-26 00:00:00
...

Install

Install from pypi:

pip install python-whois

Or checkout latest version from repository:

hg clone https://bitbucket.org/richardpenman/pywhois

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

pip install futures

Changelog

0.6 - 2015-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

Contact

You can post ideas or patches here: https://bitbucket.org/richardpenman/pywhois/issues

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

Project details


Download files

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

Files for python-whois, version 0.6.1
Filename, size File type Python version Upload date Hashes
Filename, size python-whois-0.6.1.tar.gz (18.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page