python-whois's Introduction

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