# whois

> A WHOIS client for NodeJS

Latest version **2.16.2** (published 2026-07-02) · FreeBSD license · 0 weekly downloads

## Install

```sh
npm install whois
pnpm add whois
yarn add whois
bun add whois
```

Provides the command `whois`.

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 2.16.2 |
| Published | 2026-07-02 |
| First published | 2011-12-26 |
| Weekly downloads | 0 |
| License | FreeBSD |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 42 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 262 |
| Author | Mahmud Ridwan |
| Maintainers | weppos, hjr265 |
| Keywords | whois |

## Links

- npm: https://www.npmjs.com/package/whois
- Repository: https://github.com/hjr265/node-whois
- Issues: https://github.com/hjr265/node-whois/issues
- npm.io page: https://npm.io/package/whois

## Dependencies (3)

- [socks](https://npm.io/package/socks.md) ^2.2.2
- [yargs](https://npm.io/package/yargs.md) ^15.4.1
- [underscore](https://npm.io/package/underscore.md) ^1.9.1

## Recent versions

- 2.16.2 (latest) — 2026-07-02
- 2.16.1 — 2025-11-26
- 2.15.0 — 2025-06-27
- 2.14.2 — 2024-06-04
- 2.14.1 — 2024-06-04
- 2.14.0 — 2022-11-04
- 2.13.9 — 2022-01-24
- 2.13.7 — 2021-08-29
- 2.13.6 — 2021-08-29
- 2.13.5 — 2021-05-26
- 2.13.4 — 2021-05-26
- 2.13.3 — 2020-10-23
- 2.13.1 — 2020-09-21
- 2.13.0 — 2020-08-24
- 2.12.1 — 2020-03-29
- … 35 more at https://npm.io/package/whois/versions

## README

# Node WHOIS

[![Build Status](https://drone.io/github.com/FurqanSoftware/node-whois/status.png)](https://drone.io/github.com/FurqanSoftware/node-whois/latest)

Node WHOIS is a WHOIS client for Node.js.

## Installation

### Global

    $ npm install -g whois

#### Usage

    whois [options] address

    Options:
      --version      Show version number                                   [boolean]
      -s, --server   whois server                                    [default: null]
      -f, --follow   number of times to follow redirects                [default: 0]
      -p, --proxy    SOCKS proxy                                     [default: null]
      -v, --verbose  show verbose results                 [boolean] [default: false]
      -b, --bind     bind to a local IP address                      [default: null]
      -h, --help     Show help                            [boolean] [default: false]

### Local

    $ npm install whois

#### Usage

```js
var whois = require('whois')
whois.lookup('google.com', function(err, data) {
	console.log(data)
})
```

You may pass an object in between the address and the callback function to tweak the behavior of the lookup function:

```js
{
	"server":  "",   // this can be a string ("host:port") or an object with host and port as its keys; leaving it empty makes lookup rely on servers.json
	"follow":  2,    // number of times to follow redirects
	"timeout": 0,    // socket timeout, excluding this doesn't override any default timeout value
	"verbose": false // setting this to true returns an array of responses from all servers
	"bind": null     // bind the socket to a local IP address
	"proxy": {       // (optional) SOCKS Proxy
		"host": "",
		"port": 0,
		"type": 5    // or 4
	}
}
```

## Contributing

Contributions are welcome.

## License

Node WHOIS is available under the [BSD (2-Clause) License](http://opensource.org/licenses/BSD-2-Clause).

## Other Projects Using Node WHOIS

- [Dots](https://github.com/FurqanSoftware/dots): Tiny networking toolkit. Uses Node WHOIS to perform WHOIS lookups for domains and IPs.

If you are using Node WHOIS in a project please send a pull request to add it to the list.

---
_Source: https://npm.io/package/whois · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._