whoisdomain 
- A Python package for retrieving WHOIS information of DOMAIN'S ONLY.
- Python >=3.10
- requirements:
- whodap>=0.1.16
.
- tld>=0.13.2
.
- redis (optional)
.
- whodap>=0.1.16
- v1 uses only whois and has been be moved to maintenance only
- v2 will use whodap to first retrieve info with rdap, if no data is available try the classic whois approach.
- This package will not support querying ip CIDR ranges or AS information.
- This was a copy of the original DanyCork 'whois'.
- Significantly refactored in 2023 (v1).
- RDAP adding in 2026 (v2).
- The v1 output is still compatible with DanyCork 'whois'.
- the v2 will move away from strict compatibility.
Notes:
- Rdap servers only know about the real IANA domain, the concept of first level domains is not supported when using rdap requests.
Notes
A) https://en.wikipedia.org/wiki/WHOIS
On January 19, 2023, ICANN opened voting on a global amendment to all its registry and registrar agreements. In it they defined an RDAP Ramp-Up Period of 180 days starting with the effectiveness of this amendment. 360 days after this period is defined as the WHOIS Services Sunset Date, after which it is not a requirement for registries and registrars to offer a WHOIS service and instead only an RDAP service is required. All voting thresholds were met within the 60 day voting period and the amendment was approved by the ICANN Board. The date for WHOIS Sunset for gTLDs was set as 28 January 2025.[47]
Versioning
- I will start versioning at 1.x.x
- the second item will be YYYYMMDD,
- the third item will start from 1 and be only used if more than one update will have to be done in one day.
Versions 1.x.x will keep the output compatible with Danny Cork.
Versions 2.x.x will add a dependency on whodap and use rdap based whois data before consulting historical whois.
Releases
- Releases are avalable at: Pypi
Pypi releases can be installed with:
pip install whoisdomain
Features
- See: Features
Dependencies
- please install also the command line "whois" of your distribution as this library parses the output of the "whois" cli command of your operating system
Notes for Mac users
- it has been observed that the default cli whois on Mac is showing each forward step in its output, this makes parsing the result very unreliable.
- using a brew install whois will give in general better results.
Issues
- see Issues
Docker release
- See Docker
Usage example
- See Usage
whoisdomain
- the cli
whoisdomainis documented in whoisdomain-cli
ccTLD & TLD support
Most tld's are now autodetected via IANA root db,
see the Analizer directory and make suggest.
- see the file: tld_regexpr
- for python use:
whoisdomain.validTlds() - for cli use
whoisdomain -S
Support
- Python 3.x is supported for x >= 10
Author's
- See: Authors
Updates
- see Updates for a full history of changes.
2.20260709.1
- first version 2 release
- switch to minimal version 3.10
- update gitgub-action lint (mypy) to use
setup-python@v6andcheckout@v6 - start working on v2 with rdap first
2.20260805.1
- add dependencies to the pyproject.toml file
2.20260805.2
- create a separate Issues text and rephrase the memory issue after better testing from Misiu
2.20260806.1
- test auto publish on tag push
2.20260806.2
- test again
2.20260806.3
- in 2 the pipy publish worded but the release already exists so one more time
1 maintainer
Release files for whoisdomain 2.20260806.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| whoisdomain-2.20260806.3.tar.gz | 55.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| whoisdomain-2.20260806.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 121.9 kB
Release files / whoisdomain-2.20260806.3.tar.gz
| Download URL | whoisdomain-2.20260806.3.tar.gz |
|---|---|
| Size | 55.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e10a0fa699c2413a1a2434850387ec4e8d184204fa490fd0a86e27a8c47c4a59
|
|
BLAKE2b-256 checksum How to use checksums |
24fa1a23b7fc76adac11bf691726bcfec888e1e81521a2cd12cea80873ff1e80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 6, 2026.
Transparency logRelease files / whoisdomain-2.20260806.3-py3-none-any.whl
| Download URL | whoisdomain-2.20260806.3-py3-none-any.whl |
|---|---|
| Size | 66.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a380ded41d72bbfd5a99ed8542ad04b7ac3f0b2c755d223de08c71a4b6cc8c9a
|
|
BLAKE2b-256 checksum How to use checksums |
f1e15a05631f113a8137a163a8379efa916df4d3ce4890e3c41e251dcd48cb6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 6, 2026.
Transparency log
