Introduction

A simplified Whoislookup API with a JSON response. The API returns less information, but with better accuracy than other whois lookup services.

Created by James Peret, based on the Whoiz application by Jason Ormand and using the Ruby Whois gem.

Accessing the API

Provide a URL for the API and get a nicely formatted JSON response with the domain information. You can query information in many diferent ways like directly thru the browser, with curl on the command line or with javascript. Here are some examples:

Browser

http://whois.j1x.co/jamesperet.com

curl

curl http://whois.j1x.co/jamesperet.com

Angular JS Directive

angular.module('ExampleApp', []) .service('DomainLookup', [ '$http', function($http) { domain = "" this.domainLookup = function(url){ $http({ method: 'GET', url: 'http://whois.j1x.co/' + url }).success(function(data) { console.log("Domain Lookup Successfull") console.log(data) domain = data; return domain; }); } this.get = function() { return domain; } }])

Query Options

This are the options for querying the API:

url - The domain url that will be queried. Omit the http://www..
&raw=true - the JSON response will include a raw version of the data received by the registrar
&dev=true - Only basic information and the *raw* version will be included in the *JSON* response. No parsing will be done with the data. This is useful for debuggingb>.

Example:

Example Domain Lookup response

{ "domain": "jamesperet.com", "owner": "James Peret", "registrar": "eNom Inc.", "expires_on": "2016-06-07T16:01:00.00Z", "update_on": "2015-05-13 00:00:00 -0300", "registered?": true, "available?": false }

Domain Support

For now the supported domains are: .com, .net, .com.br and .network. Support for more domains will come in the future.

The queries for .com.br domains usually come with limited information because of the registrar's API call allowance.

There is also a bug where some .com domains return an error (ex: google.com).