domainsindex logo
button

Domainindex API

1. GENERAL

The DomainIndex API allows you to integrate data from our appraisal system into your own applications. DomainIndex API is using standard HTTP requests and can provide responses in XML and JSON formats.

The API supports GET and POST requests and parameters are same for both.

API is developed to support single and volume query up to 1000 domains. Response is faster if API is used for volume queries.

All subscription types, except Starter, are allowed to use the API. Number of domains that can be checked with the API is listed at Subscriptions page under API.

2. Parameters used in API functions

Name Description
action the action you are trying to run. The possible values are:
appraise, price, searches, keyword_detection, alexa, whois, domain_availability, overture, traffic_estimator, trademark_probability, udrps, wiki, dmoz
domain aim of our request can be domain or list of domains separated by comma
mode format of returning results, available variants are xml and json
key unique API key can be found under My API in Account section

3. Supported services

Currently we are supporting following services:

3.1 APPRAISE

The appraise action provides esencial domain information from single appraisal.

Response specification

Name Description
domain Requested domain
sld SLD extracted from domain
keyword Extracted keywords from the domain
price Appraised value of the domain in USD currency
sld_local_broad_search Local searches for SLD
sld_local_broad_cpc Local CPC for SLD in USD
keyword_local_broad_search Local searches for keyword
keyword_local_broad_cpc Local CPC for keyword in USD
domain_local_broad_search Local searches for domain
domain_local_broad_cpc Local CPC for domain in USD
appraisal_permalink Link to single appraisal page for the domain
* If requested domain is gTLD than location is All Countries, so local and global searches/cpc are same.
** If requested domain is ccTLD than location is TLD country.

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <sld>example</sld>
        <keyword>example</keyword>
        <price>580000</price>
        <sld_local_broad_search>69500000</sld_local_broad_search>
        <sld_local_broad_cpc>0.94</sld_local_broad_cpc>
        <keyword_local_broad_search>69500000</keyword_local_broad_search>
        <keyword_local_broad_cpc>0.94</keyword_local_broad_cpc>
        <domain_local_broad_search>33875</domain_local_broad_search>
        <domain_local_broad_cpc>0.57</domain_local_broad_cpc>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.2 PRICE

The price action provides appraised value of the domain.

Response specification

Name Description
domain Requested domain
price Appraised value of the domain in USD currency
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <price>580000</price>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.3 SEARCHES

The searches action provides global and local as same as broad and exact search data for domain, SLD and keyword. Search data is allways fresh and it refers to the previous month. Behind previous month searches this action also provides search trends for last 11 months.

Global search data refers to all countries while local search data is for ccTLD country. If requested domain is gTLD than global and local data are same.

Response specification

Name Description
domain Requested domain
global_broad_search_domain,
global_broad_search_sld,
global_broad_search_keyword
Global broad searches for domain, sld and keyword
global_broad_aproximate_cpc_domain,
global_broad_aproximate_cpc_sld,
global_broad_aproximate_cpc_keyword
Global broad CPC for domain, sld and keyword in USD
global_broad_competition_domain,
global_broad_competition_sld,
global_broad_competition_keyword
Global broad competition for domain, sld and keyword in USD
global_exact_search_domain,
global_exact_search_sld,
global_exact_search_keyword
Global exact searches for domain, sld and keyword
global_exact_aproximate_cpc_domain,
global_exact_aproximate_cpc_sld,
global_exact_aproximate_cpc_keyword
Global exact CPC for domain, sld and keyword in USD
global_exact_competition_domain,
global_exact_competition_sld,
global_exact_competition_keyword
Global exact competition for domain, sld and keyword in %
local_broad_search_domain,
local_broad_search_sld,
local_broad_search_keyword
Local broad searches for domain, sld and keyword
local_broad_aproximate_cpc_domain,
local_broad_aproximate_cpc_sld,
local_broad_aproximate_cpc_keyword
Local broad CPC for domain, sld and keyword in USD
local_broad_competition_domain,
local_broad_competition_sld,
local_broad_competition_keyword
Local broad competition for domain, sld and keyword in %
local_exact_search_domain,
local_exact_search_sld,
local_exact_search_keyword
Local exact searches for domain, sld and keyword
local_exact_aproximate_cpc_domain,
local_exact_aproximate_cpc_sld,
local_exact_aproximate_cpc_keyword
Local exact CPC for domain, sld and keyword in USD
local_exact_competition_domain,
local_exact_competition_sld,
local_exact_competition_keyword
Local exact competition for domain, sld and keyword in %
global_broad_trends_domain,
global_broad_trends_sld,
global_broad_trends_keyword,
local_broad_trends_domain,
local_broad_trends_sld,
local_broad_trends_keyword,
global_exact_trends_domain,
global_exact_trends_sld,
global_exact_trends_keyword,
local_exact_trends_domain,
local_exact_trends_sld,
local_exact_trends_keyword
Global or local, broad or exact search trends for domain, sld and keyword.
There are 11 values for trends. First value refers to searches for 12 months ago, second value is for searches 11 months ago, and so on, last value is for 2 months ago searches.

Example:
<global_broad_trends_domain>100</global_broad_trends_domain> // global broad searches for domain 12 months ago
<global_broad_trends_domain>175</global_broad_trends_domain> // global broad searches for domain 11 months ago
<global_broad_trends_domain>300</global_broad_trends_domain> // global broad searches for domain 10 months ago
<global_broad_trends_domain>300</global_broad_trends_domain> // global broad searches for domain 9 months ago
<global_broad_trends_domain>300</global_broad_trends_domain> // global broad searches for domain 8 months ago
<global_broad_trends_domain>175</global_broad_trends_domain> // global broad searches for domain 7 months ago
<global_broad_trends_domain>100</global_broad_trends_domain> // global broad searches for domain 6 months ago
<global_broad_trends_domain>100</global_broad_trends_domain> // global broad searches for domain 5 months ago
<global_broad_trends_domain>100</global_broad_trends_domain> // global broad searches for domain 4 months ago
<global_broad_trends_domain>300</global_broad_trends_domain> // global broad searches for domain 3 months ago
<global_broad_trends_domain>300</global_broad_trends_domain> // global broad searches for domain 2 month ago
                    
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain>example.com</domain>
        <global_broad_search_domain>15125</global_broad_search_domain>
        <global_broad_aproximate_cpc_domain>0.03</global_broad_aproximate_cpc_domain>
        <global_broad_competition_domain>16</global_broad_competition_domain>
        <global_broad_trends_domain>15125</global_broad_trends_domain>
        <global_broad_trends_domain>12375</global_broad_trends_domain>
        <global_broad_trends_domain>12375</global_broad_trends_domain>
        <global_broad_trends_domain>15125</global_broad_trends_domain>
        <global_broad_trends_domain>15125</global_broad_trends_domain>
        <global_broad_trends_domain>18500</global_broad_trends_domain>
        <global_broad_trends_domain>18500</global_broad_trends_domain>
        <global_broad_trends_domain>18500</global_broad_trends_domain>
        <global_broad_trends_domain>15125</global_broad_trends_domain>
        <global_broad_trends_domain>15125</global_broad_trends_domain>
        <global_broad_trends_domain>18500</global_broad_trends_domain>
        <global_exact_search_domain>15125</global_exact_search_domain>
        <global_exact_aproximate_cpc_domain>0.03</global_exact_aproximate_cpc_domain>
        <global_exact_competition_domain>16</global_exact_competition_domain>
        <global_exact_trends_domain>15125</global_exact_trends_domain>
        <global_exact_trends_domain>12375</global_exact_trends_domain>
        <global_exact_trends_domain>12375</global_exact_trends_domain>
        <global_exact_trends_domain>15125</global_exact_trends_domain>
        <global_exact_trends_domain>15125</global_exact_trends_domain>
        <global_exact_trends_domain>18500</global_exact_trends_domain>
        <global_exact_trends_domain>18500</global_exact_trends_domain>
        <global_exact_trends_domain>18500</global_exact_trends_domain>
        <global_exact_trends_domain>15125</global_exact_trends_domain>
        <global_exact_trends_domain>15125</global_exact_trends_domain>
        <global_exact_trends_domain>18500</global_exact_trends_domain>
        <global_broad_search_sld>562500</global_broad_search_sld>
        <global_broad_aproximate_cpc_sld>0.13</global_broad_aproximate_cpc_sld>
        <global_broad_competition_sld>3</global_broad_competition_sld>
        <global_broad_trends_sld>673000</global_broad_trends_sld>
        <global_broad_trends_sld>673000</global_broad_trends_sld>
        <global_broad_trends_sld>550000</global_broad_trends_sld>
        <global_broad_trends_sld>550000</global_broad_trends_sld>
        <global_broad_trends_sld>550000</global_broad_trends_sld>
        <global_broad_trends_sld>550000</global_broad_trends_sld>
        <global_broad_trends_sld>450000</global_broad_trends_sld>
        <global_broad_trends_sld>450000</global_broad_trends_sld>
        <global_broad_trends_sld>368000</global_broad_trends_sld>
        <global_broad_trends_sld>301000</global_broad_trends_sld>
        <global_broad_trends_sld>201000</global_broad_trends_sld>
        <global_exact_search_sld>562500</global_exact_search_sld>
        <global_exact_aproximate_cpc_sld>0.13</global_exact_aproximate_cpc_sld>
        <global_exact_competition_sld>3</global_exact_competition_sld>
        <global_exact_trends_sld>673000</global_exact_trends_sld>
        <global_exact_trends_sld>673000</global_exact_trends_sld>
        <global_exact_trends_sld>550000</global_exact_trends_sld>
        <global_exact_trends_sld>550000</global_exact_trends_sld>
        <global_exact_trends_sld>550000</global_exact_trends_sld>
        <global_exact_trends_sld>550000</global_exact_trends_sld>
        <global_exact_trends_sld>450000</global_exact_trends_sld>
        <global_exact_trends_sld>450000</global_exact_trends_sld>
        <global_exact_trends_sld>368000</global_exact_trends_sld>
        <global_exact_trends_sld>301000</global_exact_trends_sld>
        <global_exact_trends_sld>201000</global_exact_trends_sld>
        <global_broad_search_keyword>562500</global_broad_search_keyword>
        <global_broad_aproximate_cpc_keyword>0.13</global_broad_aproximate_cpc_keyword>
        <global_broad_competition_keyword>3</global_broad_competition_keyword>
        <global_broad_trends_keyword>673000</global_broad_trends_keyword>
        <global_broad_trends_keyword>673000</global_broad_trends_keyword>
        <global_broad_trends_keyword>550000</global_broad_trends_keyword>
        <global_broad_trends_keyword>550000</global_broad_trends_keyword>
        <global_broad_trends_keyword>550000</global_broad_trends_keyword>
        <global_broad_trends_keyword>550000</global_broad_trends_keyword>
        <global_broad_trends_keyword>450000</global_broad_trends_keyword>
        <global_broad_trends_keyword>450000</global_broad_trends_keyword>
        <global_broad_trends_keyword>368000</global_broad_trends_keyword>
        <global_broad_trends_keyword>301000</global_broad_trends_keyword>
        <global_broad_trends_keyword>201000</global_broad_trends_keyword>
        <global_exact_search_keyword>562500</global_exact_search_keyword>
        <global_exact_aproximate_cpc_keyword>0.13</global_exact_aproximate_cpc_keyword>
        <global_exact_competition_keyword>3</global_exact_competition_keyword>
        <global_exact_trends_keyword>673000</global_exact_trends_keyword>
        <global_exact_trends_keyword>673000</global_exact_trends_keyword>
        <global_exact_trends_keyword>550000</global_exact_trends_keyword>
        <global_exact_trends_keyword>550000</global_exact_trends_keyword>
        <global_exact_trends_keyword>550000</global_exact_trends_keyword>
        <global_exact_trends_keyword>550000</global_exact_trends_keyword>
        <global_exact_trends_keyword>450000</global_exact_trends_keyword>
        <global_exact_trends_keyword>450000</global_exact_trends_keyword>
        <global_exact_trends_keyword>368000</global_exact_trends_keyword>
        <global_exact_trends_keyword>301000</global_exact_trends_keyword>
        <global_exact_trends_keyword>201000</global_exact_trends_keyword>
        <local_broad_search_domain>15125</local_broad_search_domain>
        <local_broad_aproximate_cpc_domain>0.03</local_broad_aproximate_cpc_domain>
        <local_broad_competition_domain>16</local_broad_competition_domain>
        <local_broad_trends_domain>15125</local_broad_trends_domain>
        <local_broad_trends_domain>12375</local_broad_trends_domain>
        <local_broad_trends_domain>12375</local_broad_trends_domain>
        <local_broad_trends_domain>15125</local_broad_trends_domain>
        <local_broad_trends_domain>15125</local_broad_trends_domain>
        <local_broad_trends_domain>18500</local_broad_trends_domain>
        <local_broad_trends_domain>18500</local_broad_trends_domain>
        <local_broad_trends_domain>18500</local_broad_trends_domain>
        <local_broad_trends_domain>15125</local_broad_trends_domain>
        <local_broad_trends_domain>15125</local_broad_trends_domain>
        <local_broad_trends_domain>18500</local_broad_trends_domain>
        <local_exact_search_domain>15125</local_exact_search_domain>
        <local_exact_aproximate_cpc_domain>0.03</local_exact_aproximate_cpc_domain>
        <local_exact_competition_domain>16</local_exact_competition_domain>
        <local_exact_trends_domain>15125</local_exact_trends_domain>
        <local_exact_trends_domain>12375</local_exact_trends_domain>
        <local_exact_trends_domain>12375</local_exact_trends_domain>
        <local_exact_trends_domain>15125</local_exact_trends_domain>
        <local_exact_trends_domain>15125</local_exact_trends_domain>
        <local_exact_trends_domain>18500</local_exact_trends_domain>
        <local_exact_trends_domain>18500</local_exact_trends_domain>
        <local_exact_trends_domain>18500</local_exact_trends_domain>
        <local_exact_trends_domain>15125</local_exact_trends_domain>
        <local_exact_trends_domain>15125</local_exact_trends_domain>
        <local_exact_trends_domain>18500</local_exact_trends_domain>
        <local_broad_search_sld>562500</local_broad_search_sld>
        <local_broad_aproximate_cpc_sld>0.13</local_broad_aproximate_cpc_sld>
        <local_broad_competition_sld>3</local_broad_competition_sld>
        <local_broad_trends_sld>673000</local_broad_trends_sld>
        <local_broad_trends_sld>673000</local_broad_trends_sld>
        <local_broad_trends_sld>550000</local_broad_trends_sld>
        <local_broad_trends_sld>550000</local_broad_trends_sld>
        <local_broad_trends_sld>550000</local_broad_trends_sld>
        <local_broad_trends_sld>550000</local_broad_trends_sld>
        <local_broad_trends_sld>450000</local_broad_trends_sld>
        <local_broad_trends_sld>450000</local_broad_trends_sld>
        <local_broad_trends_sld>368000</local_broad_trends_sld>
        <local_broad_trends_sld>301000</local_broad_trends_sld>
        <local_broad_trends_sld>201000</local_broad_trends_sld>
        <local_exact_search_sld>562500</local_exact_search_sld>
        <local_exact_aproximate_cpc_sld>0.13</local_exact_aproximate_cpc_sld>
        <local_exact_competition_sld>3</local_exact_competition_sld>
        <local_exact_trends_sld>673000</local_exact_trends_sld>
        <local_exact_trends_sld>673000</local_exact_trends_sld>
        <local_exact_trends_sld>550000</local_exact_trends_sld>
        <local_exact_trends_sld>550000</local_exact_trends_sld>
        <local_exact_trends_sld>550000</local_exact_trends_sld>
        <local_exact_trends_sld>550000</local_exact_trends_sld>
        <local_exact_trends_sld>450000</local_exact_trends_sld>
        <local_exact_trends_sld>450000</local_exact_trends_sld>
        <local_exact_trends_sld>368000</local_exact_trends_sld>
        <local_exact_trends_sld>301000</local_exact_trends_sld>
        <local_exact_trends_sld>201000</local_exact_trends_sld>
        <local_broad_search_keyword>562500</local_broad_search_keyword>
        <local_broad_aproximate_cpc_keyword>0.13</local_broad_aproximate_cpc_keyword>
        <local_broad_competition_keyword>3</local_broad_competition_keyword>
        <local_broad_trends_keyword>673000</local_broad_trends_keyword>
        <local_broad_trends_keyword>673000</local_broad_trends_keyword>
        <local_broad_trends_keyword>550000</local_broad_trends_keyword>
        <local_broad_trends_keyword>550000</local_broad_trends_keyword>
        <local_broad_trends_keyword>550000</local_broad_trends_keyword>
        <local_broad_trends_keyword>550000</local_broad_trends_keyword>
        <local_broad_trends_keyword>450000</local_broad_trends_keyword>
        <local_broad_trends_keyword>450000</local_broad_trends_keyword>
        <local_broad_trends_keyword>368000</local_broad_trends_keyword>
        <local_broad_trends_keyword>301000</local_broad_trends_keyword>
        <local_broad_trends_keyword>201000</local_broad_trends_keyword>
        <local_exact_search_keyword>562500</local_exact_search_keyword>
        <local_exact_aproximate_cpc_keyword>0.13</local_exact_aproximate_cpc_keyword>
        <local_exact_competition_keyword>3</local_exact_competition_keyword>
        <local_exact_trends_keyword>673000</local_exact_trends_keyword>
        <local_exact_trends_keyword>673000</local_exact_trends_keyword>
        <local_exact_trends_keyword>550000</local_exact_trends_keyword>
        <local_exact_trends_keyword>550000</local_exact_trends_keyword>
        <local_exact_trends_keyword>550000</local_exact_trends_keyword>
        <local_exact_trends_keyword>550000</local_exact_trends_keyword>
        <local_exact_trends_keyword>450000</local_exact_trends_keyword>
        <local_exact_trends_keyword>450000</local_exact_trends_keyword>
        <local_exact_trends_keyword>368000</local_exact_trends_keyword>
        <local_exact_trends_keyword>301000</local_exact_trends_keyword>
        <local_exact_trends_keyword>201000</local_exact_trends_keyword>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.4 KEYWORD DETECTION

Keyword detection extracts keyword from requested domain and provides keyword language and probability.

Response specification

Name Description
domain Requested domain
keywords Extracted keywords from domain SLD
language1 Detected language for keywords, with biggest probability
language1_probability Language1 probability in %
language1_frequency Language1 frequency in language1 ngrams
language2 Second detected language for keywords
language2_probability Language2 probability in %
language3 Third detected language for keywords
language3_probability Language3 probability in %
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <keywords>example</keywords>
        <language1>English</language1>
        <language1_probability>100</language1_probability>
        <language1_frequency>305278</language1_frequency>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
        <language2>N/A</language2>
        <language2_probability>N/A</language2_probability>
        <language3>N/A</language3>
        <language3_probability>N/A</language3_probability>
    </domain-example.com>
</response>

3.5 ALEXA

The alexa action provides alexa rank for the domain.

Response specification

Name Description
domain Requested domain
alexa Alexa rank for the domain
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <alexa>52790</alexa>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.6 WHOIS

Whois action provides whois information about requested domain.

Response specification

Name Description
domain Requested domain
domain_birthdate Domain registration date
age Domain age
expiration_date Domain expiration date
nameservers Current nameservers
whois_last_update Last update date
owner_name,
admin_name,
technical_name,
billing_name
owner, admin, technical and billing name
owner_email,
admin_email,
technical_email,
billing_email
owner, admin, technical and billing email
owner_phone,
admin_phone,
technical_phone,
billing_phone
owner, admin, technical and billing phone
owner_fax,
admin_fax,
technical_fax,
billing_fax
owner, admin, technical and billing fax
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <domain_birthdate>14-Aug-1995</domain_birthdate>
        <age>18</age>
        <expiration_date>13-Aug-2012</expiration_date>
        <nameservers>A.IANA-SERVERS.NET,B.IANA-SERVERS.NET</nameservers>
        <whois_last_update>14-aug-2011</whois_last_update>
        <owner_name/>
        <owner_email/>
        <owner_phone/>
        <owner_fax/>
        <admin_name/>
        <admin_email/>
        <admin_phone/>
        <admin_fax/>
        <technical_name/>
        <technical_email/>
        <technical_phone/>
        <technical_fax/>
        <billing_name/>
        <billing_email/>
        <billing_phone/>
        <billing_fax/>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.7 DOMAIN AVAILABILITY

Domain availability extracts SLD from requested domain and provides availability in 12 tlds.

Response specification

Name Description
domain Requested domain
domain_availability Under domain availability are listed following tlds:
com, net, org, info, asia, biz, mobi, us, xxx, name, tel, pro with value taken or free
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
    <domain>example.com</domain>
    <domain_availability>
        <com>taken</com>
        <net>taken</net>
        <org>taken</org>
        <info>free</info>
        <asia>free</asia>
        <biz>free</biz>
        <mobi>free</mobi>
        <us>free</us>
        <xxx>free</xxx>
        <name>free</name>
        <tel>free</tel>
        <pro>free</pro>
    </domain_availability>
    <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.8 OVERTURE

The overture action provides overture value of the domain.

Response specification

Name Description
domain Requested domain
overture Overture value of the domain
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <overture>9826</overture>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.9 TRAFFIC ESTIMATOR

Traffic estimator provides estimated daily visitors for the domain.

Response specification

Name Description
domain Requested domain
estimated_daily_visitors Estimated daily visitors
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <estimated_daily_visitors>20608</estimated_daily_visitors>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.10 TRADEMARK PROBABILITY

Trademark probability action provides trademark probability of the domain.

Response specification

Name Description
domain Requested domain
trademark_probability Trademark probability
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <trademark_probability>0</keywords>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.11 UDRPS

The udrps action provides udrps of the domain.

Response specification

Name Description
domain Requested domain
udrps udrps
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <udrps/>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.12 WIKI

The wiki action provides url to wikipedia article for domain keyword.

Response specification

Name Description
domain Requested domain
wiki Url to wikipedia article for domain keyword
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <wiki>http://en.wikipedia.org/wiki/Example</wiki>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

3.13 DMOZ

The dmoz action provides information whether the domain keyword is listed at DMOZ.

Response specification

Name Description
domain Requested domain
dmoz true or false, Indicates whether the domain keyword is listed at DMOZ.
appraisal_permalink Link to single appraisal page for the domain

Example

Query example:
<?xml version="1.0" encoding="UTF-8"?>                    
<response>
    <domain-example.com>
        <domain>example.com</domain>
        <dmoz>false</dmoz>
        <appraisal_permalink>http://domainindex.com/domains/example.com</appraisal_permalink>
    </domain-example.com>
</response>

4. ERRORS

There are some errors that can occure while using Domainindex API.

4.1 LIMIT PER SECOND

Domainindex API has limit of 1 request per 5 seconds.
If you reach this limit will appear message: You've reached the request limit per second.
This limitation can be skipped by using volume query with up to 1000 domains instead many single queries.

4.2 UNSUPPORTED TLD

Domainindex supports following TLD:

  • gTLD: com, net, org, name, asia, biz, eu, xxx, info, mobi, tel, pro, aero, travel, museum, coop.
  • ccTLD: at, au, be, br, ca, cc, ch, cl, cn, co, cr, cu, cz, de, dk, es, fi, fr, ar, ag, gr, hk, hu, ie, il, in, ir, is, it, jp, kr, li, lu, md, me, mx, my, ng, nl, no, nz, pe, pk, pl, pt, ro, ru, se, sg, sk, tv, tr, tw, ua, uk, us, ve, vn, ws, za.

The message that appears if API is used for domains with unsupported tld is: Please enter one or more valid domains. Same message appears and if user add words instead domains from supported TLDs.

4.3 SPEND API REQUESTS

If there are no more API requests the message that will appear is: Api requests limit reached.

4.4 INVALID KEY

If user use API with wrong api key the message that will appear is: Invalid key.

4.5 INVALID MODE

If user enter mode different than xml or json the message that will appear is: Invalid mode.

5. CODE SAMPLES

To facilitate API implementation we are providing POST and GET samples. We are providing PHP samples, but as long the client language is capable of generating HTTP POST request (i.e. application/x-www-form-urlencoded), any combination of required fields submitted via either GET (appended to the URL) or via POST (in the body of POST request) should work.

5.1 POST SAMPLE

Sample PHP code for appraise

<?php

$data = array(
   'action' => 'appraise',
   'domain' => 'a.com,b.com',    // up to 1000 domains
   'mode'   => 'xml',
   'key'    => '123wera4-318a-4op5-mi6q-sub39venc11f'    // your api key
);

$ch = curl_init('http://domainindex.com/api.php?action=appraise');
curl_setopt_array($ch, array(
   CURLOPT_POST  => TRUE,
   CURLOPT_POSTFIELDS => $data,
   CURLOPT_RETURNTRANSFER => TRUE,
));
$result = curl_exec($ch);

echo $result;

?>

5.1 GET SAMPLE

Sample PHP code for appraise

<?php

$data = array(
   'action' => 'appraise',
   'domain' => 'example.com',     // up to 1000 domains separated by comma
   'mode'   => 'json',
   'key'    => '123wera4-318a-4op5-mi6q-sub39venc11f'    // your api key
);

$url = 'http://domainindex.com/api.php?' . http_build_query($data); $result = file_get_contents($url);

echo $result;

// Decode JSON response
$decoded = json_decode($result, TRUE);
print_r($decoded);
       
?>