Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A whois module for Node that supports multiple TLDs
JavaScript CoffeeScript
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib/whois add .sexy
node_modules/underscore first commit
package.json add .sexy first commit
whoisjs.js .io search wasn't working properly


A WHOIS module for Node.js written in CoffeeScript. WhoisJS is able to perform lookups on over 200 TLDs.


This library has been tested with Node.JS v0.4.12 and v0.10.26

How to Install

$ npm install whoisjs

How to Use

  Whoisjs = require('whoisjs').whois

  who = new Whoisjs()
  domain = ""

  who.query domain, (response) ->
    state = "available" if response.available()
    state = "unavailable" if response.unavailable()
    state = "timeout" if response.timeout()
    state = "error" if response.error()
    state ||= "unknown"
    callback(domain, state);

How to debug

Show me the whois response already!

From the above, response.raw contains the response data from the Whois server. console.log it, and see what's happening.

The lib/whois/server/adapters files describe how the response is interpreted via the positive(), negative(), and error() functions. If you notice the responses aren't being registered correctly, please file an issue or send a pull request, and it'll get fixed up!


WhoisJS is released under the MIT license.


WhoisJS is inspired by Ruby Whois


Julian Giuca.

Please feel free to contact me with any questions, tips, or suggestions.

Something went wrong with that request. Please try again.