Skip to main content

whois21

version stars forks pipeline status

WHOIS21 is a simple and easy to use python package that lets you easily query whois information of a domain.

Features

WHOIS

  • Query whois information of a TLD from various whois servers and parse the results.
  • Get the Registration Information of a domain from different RDAP servers and parse the results.
  • Get IP information from ip-api.com.
  • Any idea? Feel free to open an issue or submit a merge request.

Issues

Installation

Well, this is a python package so the first thing you need is python.

If you don't have python installed, please visit Python.org and install the latest version of python based on your OS.

Then you can install whois21 using pip module:

# Use this command to get the latest version from pypi.org and install it automatically
python -m pip install whois21 -U

# OR
# Download the release file from GitLab: https://gitlab.com/CodeWriter21/whois21/-/releases
# And install it using this command
pip install whois21-x.x.x.tar.gz

Or you can clone the repository and run:

python -m build .

Dependencies

  • httpx: Used for:
    • Downloading list of whois and RDAP servers.
    • Downloading RDAP information.
  • importlib_resources: Used for:
    • Reading the bundled fallback copies of the server lists.
  • platformdirs: Used for:
    • Locating the user cache directory for RDAP/WHOIS bootstrap files.
  • chardet: Used for:
    • Detecting the encoding of the whois response.
  • log21: Used for:
    • Argument Parsing.
    • Colorized Logging.
    • Printing collected data in pprint or tree format.
  • os (A core python module): Used for:
    • Working with files and directories.
  • asyncio (A core python module): Used for:
    • Establishing async TCP connections to the whois servers.
    • Running concurrent lookups.
  • json (A core python module): Used for:
    • Parsing JSON data from RDAP servers.
    • Parsing RDAP server list.
    • Saving collected whois or/and RDAP data to a file.
    • Loading some package data from a file.
  • datetime (A core python module): Used for:
    • Converting Creation/Updated/Expiration date to a usable python datetime object.
  • ipaddress (A core python module): Used for:
    • Validating IPv4 and IPv6 addresses.
  • typing (A core python module): Used for:
    • Type checking.
    • Type hinting.

Changes

2.0.2

  • Updated log21 to 3.10.3.

Usage Examples

CLI Examples

  • Example 1: Query whois information of google.com
# -v : verbose mode
whois21 -v google.com
  • Example 2: Query whois information of 3 domains and save the results to a directory
# -R : saves the results as raw text
# -n: avoids printing the results to the screen
# -o results: saves the results to `./results` directory
whois21 -R -n -o results google.com facebook.com pinterest.com
  • Example 3: Query whois information of 3 IPs and save the results to a directory
# Options explained in the examples above
whois21 -R -n -v -o results 1.1.1.1 157.240.20.174 64.91.226.82
  • Example 4: Query RDAP information of domains and IPs and save the results to a file
# -r: Gets the RDAP information of the queried domains and IPs
whois21 -n -o results -r microsoft.com python.org 140.82.121.3 185.147.178.13

Python Code Examples

  • Example 1: Query whois information of GitHub.com (synchronous).
# First step is to import the package
import whois21

query = 'github.com'

# Second step is to run the lookup (raises WhoisError when every strategy fails;
# pass on_error='capture' to get success/error attributes instead)
whois = whois21.query(query)

# And basically you are done!
# Now you can print the results
import log21  # I use log21 to print the results in a cool way 8D

# Print the results in a nice way
# PPrint the dictionary
log21.pprint(whois.whois_data)
# Tree-Print the dictionary
log21.tree_print(whois.whois_data)

# Or you can print the results in as raw text
print(whois.raw.decode('utf-8'))

# Or you can access each part of the results individually
print(f'Creation date   : {whois.creation_date}')
print(f'Expiration date : {whois.expires_date}')
print(f'Updated date    : {whois.updated_date}')
  • Example 2: The same lookup, asynchronously.
import asyncio
import whois21


async def main():
    whois = await whois21.aquery('github.com')
    print(whois.creation_date)


asyncio.run(main())

About

Author: CodeWriter21 (Mehrad Pooryoussof)

GitLab: CodeWriter21

Telegram Channel: @CodeWriter21

Aparat Channel: CodeWriter21

License

License

apache-2.0

Donate

In order to support this project you can donate some crypto of your choice 8D

Donate Addresses

Or if you can't, simply give this project one star on GitLab :)

References

Metadata

Release files for whois21 2.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for whois21 2.0.2
File Size Uploaded Provenance Actions
whois21-2.0.2.tar.gz 38.9 kB Without provenance Details for whois21-2.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for whois21 2.0.2
File Interpreter ABI Platform Actions
whois21-2.0.2-py3-none-any.whl Python 3 none any Details for whois21-2.0.2-py3-none-any.whl

Total release size: 82.3 kB

Release files / whois21-2.0.2.tar.gz

Download URL whois21-2.0.2.tar.gz
Size 38.9 kB
Tags Source
SHA-256 checksum
How to use checksums
df7c4ab41a099009e1d4732e29061108219b14fa4c06b9e4d29514c634a65335
BLAKE2b-256 checksum
How to use checksums
533665077cb689addb3c2aeffbd59f372c88ff1ac02ebf03e4d564e83aafc16e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.12 {"installer":{"name":"uv","version":"0.12.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / whois21-2.0.2-py3-none-any.whl

Download URL whois21-2.0.2-py3-none-any.whl
Size 43.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1a077133a924c5a1e7979bf67be27ad5b7fee0d898b146241eea58c2f839a71a
BLAKE2b-256 checksum
How to use checksums
6181d3e30bfa7cbdb29874477f156e28948550065fa5af35ede6fceb017eebb4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.12 {"installer":{"name":"uv","version":"0.12.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for whois21 2.0.2

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page