JSON API

Introduction

The JSON API has two methods: Search and Info.

Each responds to a GET request. When called with the optional callback parameter, the return value will be wrapped with your callback function:

http://domai.nr/api/json/search?q=domainr&callback=foobar

foobar({"query":"domainr", "results":[]})

Methods

Search

Responds to a GET request with the arguments specified in the query string:

http://domai.nr/api/json/search?q=domainr

The response will be a JSON object:

{
    "query": "domai.nr",
    "results": [{
        "domain": "domai.nr",
        "register_url": "http://domai.nr/domai.nr/register",
        "host": "",
        "path": "",
        "subdomain": "domai.nr",
        "availability": "taken"
    },
    {
        "domain": "dom.ai",
        "register_url": "http://domai.nr/dom.ai/register",
        "host": "",
        "path": "/nr",
        "subdomain": "dom.ai",
        "availability": "available"
    },
    {
        "domain": "doma.in",
        "register_url": "http://domai.nr/doma.in/register",
        "host": "",
        "path": "/r",
        "subdomain": "doma.in",
        "availability": "taken"
    },
    {
        "domain": "do.ma",
        "register_url": "http://domai.nr/do.ma/register",
        "host": "",
        "path": "/i.nr",
        "subdomain": "do.ma",
        "availability": "maybe"
    },
    {
        "domain": "d.om",
        "register_url": "http://domai.nr/d.om/register",
        "host": "",
        "path": "/ai.nr",
        "subdomain": "d.om",
        "availability": "unavailable"
    },
    {
        "domain": "do",
        "register_url": "http://domai.nr/do/register",
        "host": "",
        "path": "/mai.nr",
        "subdomain": "do",
        "availability": "tld"
    }]
}

Any errors will be presented in a top level key in the response object:

{
    "query": "",
    "results": [],
    "error": {
        "status": 404,
        "message": "No results found."
    }
}

Info

Responds to a GET request with the arguments specified in the query string:

http://domai.nr/api/json/info?q=domainr

The response will be a JSON object:

{
    "domain": "domai.nr",
    "whois_url": "http://domai.nr/domai.nr/whois",
    "register_url": "http://domai.nr/domai.nr/register",
    "tld": {
        "domain": "nr",
        "domain_idna": "nr",
        "wikipedia_url": "http://wikipedia.org/wiki/.nr",
        "iana_url": "http://www.iana.org/domains/root/db/nr.html"
    },
    "registrars": [{
        "registrar": "cenpac.net.nr",
        "name": "CenpacNET",
        "register_url": "http://domai.nr/domai.nr/register/cenpac.net.nr"
    }],
    "host": "",
    "path": "",
    "www_url": "http://domai.nr/domai.nr/www",
    "query": "domai.nr",
    "subdomain": "domai.nr",
    "domain_idna": "domai.nr",
    "availability": "taken"
}