This IP2WHOIS command line tool provides a rapid and efficient means to access WHOIS domain information for a specific domain name, catering to the needs of users, network administrators and developers. You register for a free API key to start using it.

Get Started for FREE

How to install IP2WHOIS CLI

IP2WHOIS supports various installation methods for different operating systems. Below is the installation guide using the "Go Install" method.

go install github.com/ip2whois/ip2whois-cli/ip2whois@latest

For alternative installation, please visit the IP2WHOIS GitHub or click on the button below.

 Windows  Debian  Git

How to configure the IP2WHOIS API Key

You will need an API key to get started. If you don't have one, register for a free IP2WHOIS API key and follow the instructions in the documentation page below to configure the API key.

ip2whois config <API KEY>

Example of Domain WHOIS Lookup

Query WHOIS for specific domain

You can specify a domain WHOIS to manually look up the domain information of that specific domain. The result will be returned in JSON format.

ip2whois locaproxy.com

Output

{"domain":"locaproxy.com","domain_id":"1710914405_DOMAIN_COM-VRSN","status":"clientTransferProhibited https://icann.org/epp#clientTransferProhibited","create_date":"2012-04-03T02:34:32Z","update_date":"2021-12-03T02:54:57Z","expire_date":"2024-04-03T02:34:32Z","domain_age":4301,"whois_server":"whois.godaddy.com","registrar":{"iana_id":"146","name":"GoDaddy.com, LLC","url":"https://www.godaddy.com"},"registrant":{"name":"Registration Private","organization":"Domains By Proxy, LLC","street_address":"DomainsByProxy.com","city":"Tempe","region":"Arizona","zip_code":"85284","country":"US","phone":"+1.4806242599","fax":"","email":"Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"},"admin":{"name":"Registration Private","organization":"Domains By Proxy, LLC","street_address":"DomainsByProxy.com","city":"Tempe","region":"Arizona","zip_code":"85284","country":"US","phone":"+1.4806242599","fax":"","email":"Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"},"tech":{"name":"Registration Private","organization":"Domains By Proxy, LLC","street_address":"DomainsByProxy.com","city":"Tempe","region":"Arizona","zip_code":"85284","country":"US","phone":"+1.4806242599","fax":"","email":"Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"},"billing":{"name":"","organization":"","street_address":"","city":"","region":"","zip_code":"","country":"","phone":"","fax":"","email":""},"nameservers":["vera.ns.cloudflare.com","walt.ns.cloudflare.com"]}

Pretty print the result

To improve visibility, you can add the "-o pretty" option to display the result output in a more organized format instead of a single line.

ip2whois -o pretty locaproxy.com

Output

{
    "domain": "locaproxy.com",
    "domain_id": "1710914405_DOMAIN_COM-VRSN",
    "status": "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
    "create_date": "2012-04-03T02:34:32Z",
    "update_date": "2021-12-03T02:54:57Z",
    "expire_date": "2024-04-03T02:34:32Z",
    "domain_age": 4301,
    "whois_server": "whois.godaddy.com",
    "registrar": {
        "iana_id": "146",
        "name": "GoDaddy.com, LLC",
        "url": "https://www.godaddy.com"
    },
    "registrant": {
        "name": "Registration Private",
        "organization": "Domains By Proxy, LLC",
        "street_address": "DomainsByProxy.com",
        "city": "Tempe",
        "region": "Arizona",
        "zip_code": "85284",
        "country": "US",
        "phone": "+1.4806242599",
        "fax": "",
        "email": "Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"
    },
    "admin": {
        "name": "Registration Private",
        "organization": "Domains By Proxy, LLC",
        "street_address": "DomainsByProxy.com",
        "city": "Tempe",
        "region": "Arizona",
        "zip_code": "85284",
        "country": "US",
        "phone": "+1.4806242599",
        "fax": "",
        "email": "Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"
    },
    "tech": {
        "name": "Registration Private",
        "organization": "Domains By Proxy, LLC",
        "street_address": "DomainsByProxy.com",
        "city": "Tempe",
        "region": "Arizona",
        "zip_code": "85284",
        "country": "US",
        "phone": "+1.4806242599",
        "fax": "",
        "email": "Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"
    },
    "billing": {
        "name": "",
        "organization": "",
        "street_address": "",
        "city": "",
        "region": "",
        "zip_code": "",
        "country": "",
        "phone": "",
        "fax": "",
        "email": ""
    },
    "nameservers": [
        "vera.ns.cloudflare.com",
        "walt.ns.cloudflare.com"
    ]
}

Query WHOIS for specific domain and show only specific result fields

Instead of displaying the complete set of information, you have the option to customize the display and output specific fields. For example, the code below will display the domain name, domain ID, status, creation date, and registrar name.

ip2whois -f domain,domain_id,status,create_date,registrar.name locaproxy.com

Output

domain,domain_id,status,create_date,registrar.name
"locaproxy.com","1710914405_DOMAIN_COM-VRSN","clientTransferProhibited https://icann.org/epp#clientTransferProhibited","2012-04-03T02:34:32Z","GoDaddy.com, LLC"

Convert normal domain name to Punycode

You can convert normal domain name to Punycode. The example below is using täst.de as domain name, you may replace it with your own domain.

ip2whois normal2puny täst.de

Output

xn--tst-qla.de

Convert Punycode to normal domain name

You can convert Punycode to normal domain name. The example below is using xn--tst-qla.de as domain name, you may replace it with your own domain.

ip2whois puny2normal xn--tst-qla.de

Output

täst.de

The above examples demonstrate several usage scenarios. To learn more about the supported parameters, you can invoke "ip2whois -h".

IP Geolocation CLI

Looking for IP Geolocation Command Line Tool?
IP geolocation CLP allows you to retrieve IP geolocation information of an IP address. such as country, region, city, domain, usage type, proxy, and more.


Discover Domain Information Instantly With WHOIS Domain REST API

Try It For FREE Now