# 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.4+ and no external dependencies


# Example #


```
#!python

>>> 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:


```
#!python

pip install python-whois

```

Or checkout latest version from repository:

```
#!python

hg clone https://code.google.com/p/pywhois/ 

```

# Contact #
You can post ideas or patches here: [https://bitbucket.org/richardpenman/pywhois/issues](https://bitbucket.org/richardpenman/pywhois/issues)

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