🌍 Whoiser

whoiser is a WHOIS client for Node.js that helps with querying WHOIS servers for TLDs, domain names, AS numbers and IPs.

Has support for auto-discovery WHOIS servers for TLDs and IPs allocators, making it easy to get WHOIS info with a single call like whoiser('google.com') or whoiser('1.1.1.1').
Applies minimal parsing to results, returning same data format from different WHOIS servers.

> [!CAUTION]
> v2 is under active development! The code in main branch is for v2. Breaking changes:
> - ESM only
> - removed whoiser() method, use individual whoisDomain, whoisTld, whoisIp, whoisAsn
> - removed allTlds()
>
> Until v2 dev is complete, install latest v1. The docs below are for v1

$3

* Returns WHOIS info for any internet address
* Requires zero config, but configurable when needed
* Recognises queries and routes the request to correct server
* Minimal parsing to provide consistent results across WHOIS servers
* Uses WHOIS servers from IANA, if not provided
* Discover all available TLDs

→ See it in action here https://dmns.app

Getting Started

#### Installation

``npm i whoiser`

#### Usage
The library has a simple API.
Use whoiser(query) with any query you would want OR use specific functions with options like whoiser.domain(domain, {options}), whoiser.ip(ip, {options})

#### Example
`js
const whoiser = require('whoiser')

const domainWhois = whoiser('google.com')
const tldWhois = whoiser('.net')
const ipWhois = whoiser('1.1.1.1')
`

→ See all examples

Client API


- whoiser(query, options) - Get WHOIS data for any internet address
- whoiser.domain(domain, options) - Get parsed WHOIS data for a domain
- whoiser.tld(tld, options) - Get WHOIS data for a TLD
- whoiser.asn(asn, options) - Get WHOIS data for an AS number
- whoiser.ip(ip, options) - Get WHOIS data for a IP
- whoiser.allTlds - Returns a list of all TLDs, downloaded from IANA
- whoiser.query(options) - Query a WHOIS server for data

$3

Get WHOIS info for domains.

whoiser.domain(domain, options): Promise>
- domain - Domain name, excluding any subdomain. Ex: 'google.com'
- options - Object of options to use, all optional:
- host - WHOIS server to query. Default: WHOIS server from IANA
- timeout - WHOIS server request timeout in ms. Default: 1500
- follow - How many WHOIS server to query. 1 = registry server (faster), 2 = registry + registrar (more domain details). Default: 2
- raw - Return the raw WHOIS result in response. Added to __raw
- ignorePrivacy - Show or hide the WHOIS protected data from response, accepts boolean. Default: true

`js
const whoiser = require('whoiser');

(async () => {

// WHOIS info from Registry (Verisign) AND Registrar (MarkMonitor) whois servers
let domainInfo = await whoiser('google.com')

// OR with options for whois server and how many WHOIS servers to query
let domainInfo2 = await whoiser.domain('blog.google', {host: 'whois.nic.google', follow: 1})

console.log(domainInfo, domainInfo2)
})();
`
Returns a promise which resolves with an Object of WHOIS servers checked:
`js
{
"whois.verisign-grs.com": {
"Domain Name": "GOOGLE.COM",
"Registrar WHOIS Server": "whois.markmonitor.com",
...
},
"whois.markmonitor.com": {
"Domain Name": "google.com",
"Creation Date": "1997-09-15T00:00:00-0700",
"Expiry Date": "2020-09-13T21:00:00-0700",
"Registrar": "MarkMonitor, Inc.",
"Domain Status": [
"clientUpdateProhibited",
"clientTransferProhibited"
],
...
"Name Server": [
"ns1.google.com",
"ns2.google.com"
],
"text": [
"For more information on WHOIS status codes, please visit:",
...
]
}
}
`

$3

Get WHOIS info for IPs

whoiser.ip(ip, options): Promise