/python-whois

Python module/library for retrieving WHOIS information of domains 💻❤

Primary LanguagePythonDo What The F*ck You Want To Public LicenseWTFPL

whois
=====
A Python package for retrieving WHOIS information of domains.

Features
=============
 * Python wrapper for Linux "whois" command.
 * Simple interface to access parsed WHOIS data for a given domain.
 * Able to extract data for all the popular TLDs (com, org, net, biz, info, pl, jp, uk, nz,  ...).
 * Query a WHOIS server directly instead of going through an intermediate web service like many others do.
 * Works with Python 3.x.
 * All dates as datetime objects.
 * Possibility to cache results.

Help Wanted
===========
Your contributions are welcome , look for the Help wanted tag https://github.com/DannyCork/python-whois/labels/help%20wanted

Usage example
=============

Install `whois` package from your distribution (e.g apt install whois)

$pip install whois

>>> import whois
>>> domain = whois.query('google.com')

>>> print(domain.__dict__)
{
	'expiration_date': datetime.datetime(2020, 9, 14, 0, 0),
	'last_updated': datetime.datetime(2011, 7, 20, 0, 0),
	'registrar': 'MARKMONITOR INC.',
	'name': 'google.com',
	'creation_date': datetime.datetime(1997, 9, 15, 0, 0)
}

>>> print(domain.name)
google.com

>>> print(domain.expiration_date)
2020-09-14 00:00:00


ccTLD & TLD support
===================
.ac.uk
.am
.amsterdam
.ar
.at
.au
.aw
.bank
.be
.biz
.br
.by
.ca
.cc
.cl
.club
.cn
.co
.co.il
.co.jp
.com
.com.au
.com.tr
.courses
.cr
.cz
.de
.download
.edu
.education
.eu
.fi
.fm
.fr
.frl
.game
.global
.hk
.id
.ie
.im
.in
.info
.ink
.io
.ir
.is
.it
.jp
.kr
.kz
.link
.lt
.lv
.me
.ml
.mobi
.mu
.mx
.name
.net
.ninja
.nl
.nu
.nyc
.nz
.online
.org
.pe
.pharmacy
.pl
.press
.pt
.pub
.pw
.rest
.ru
.ru.rf
.rw
.sale
.se
.security
.sh
.site
.space
.store
.study
.tech
.tel
.theatre
.tickets
.trade
.tv
.tz
.ua
.uk
.us
.uz
.video
.website
.wiki
.work
.xyz
.za

Issues
=============
Raise an issue https://github.com/DannyCork/python-whois/issues/new


Support
=======
Python 3.x supported. 
Python 2.x NOT supported.