Nav view search
Search
Domain Info API
The domainAPI info API enables you to rapidly retrieve data related to the hosted web page of a specific domain.
Such information include traffic, historical traffic data, traffic ranking including country specific ranking, displayed name, average load time, related sub-domain, linked websites… and more information essential when analyzing a domain name in term of its past or current usage and potential.
As for now the main source of data for this API is Alexa. We will enhance this API by adding additional sources.
Parameters of the Domain Info API
The info service doesn't take parameters.
Response groups of the Domain Info API
| Name | Description |
|---|---|
| contentData | Returns information specific to a site's page content of a given URL. |
| trafficData | Returns Traffic Rank and Usage Statistics for the given site. |
| related | Returns up to 10 related links and up to 2 DMOZ categories. |
| keywords | Returns a list of keywords that identify concepts or content on this site. |
| ownedDomains | Returns a list of other domain names that are owned by the same owner as this site. |
| adultContent | Returns 'no' if the site is unlikely to contain adult content and 'yes' if it is likely to contain adult content. |
| speed | Returns the median load time and percent of known sites that are slower. |
| language | Returns content language code and character-encoding for the given website. Note that this may not match the language or character encoding of any given page on the website because the languange and character set returned are those of the majority of pages on the site. |
| linksInCount | Return a count of links pointing in to this site. |
| siteData | Returns the Title, Description, and the date created for this site. |
| rankByCountry | Shows percentage of viewers, page views, and traffic rank based on the country of users who visit the site. |
| rank | Returns the three month average traffic rank for the given site. |
| usageStatistics | Returns Usage Statistics, such as Reach and PageView information for the given site. |
| contributingSubdomains | Returns Contributing Subdomains, such as Reach and PageView information for subdomains of the given site. |
| relatedLinks | Returns up to 10 related links for the specified site or web page. |
| categories | Returns up to 2 DMOZ categories for the specified site. |
Example of the Domain Info API
JSON
Request
GET /encrypted-area HTTP/1.1
Host: api.domainapi.com/v1/info/example.com
Authorization: Basic YWtpcmF0ZXN0OmR0d3N0ZXN0
Response
Response (voluntarily incomplete due to the real response's size)
Server: Apache-Coyote/1.1
Content-Type: application/json
Transfer-Encoding: chunked
Date: Tue, 03 Feb 2009 15:09:07 GMT
Show/Hidden javascript code
{
"service": "info",
"domain": "example.com",
"timestamp": 1234567890,
"content": {
"info": {
"contentData": {
"keywords": "",
"ownedDomains": "",
"adultContent": "no",
"dataUrl": "example.com",
"speed": {
"percentile": "97",
"medianLoadTime": "344"
},
"language": {
"locale": "en"
},
"linksInCount": "20164",
"siteData": {
"title": "Internet Assigned Numbers Authority",
"onlineSince": "14-Aug-1995"
},
"type":"canonical"
},
"trafficData": {
"rankByCountry": [
{
"country": {
"rank": "22601",
"contribution": {
"users": "21.4%",
"pageViews": "28.6%"
},
"code":"US"
}
},
{
"country": {
"rank": "15875",
"contribution": {
"users": "14.4%",
"pageViews": "8.5%"
},
"code":"DE"
}
},
{
"country": {
"rank": "23780",
"contribution": {
"users": "9.3%",
"pageViews": "5.3%"
},
"code":"IN"
}
}
],
"rank": "22609",
"usageStatistics": [
{
"usageStatistic": {
"reach": {
"rank": {
"delta": "-5328",
"value": "18141"
},
"perMillion": {
"delta": "+30%",
"value": "57.8"
}
},
"pageViews": {
"perUser": {
"delta": "-26%",
"value": "1.72"
},
"rank": {
"delta": "1996",
"value": "45075"
},
"perMillion": {
"delta": "-4%",
"value": "1.4"
}
},
"rank": {
"delta": "-3705",
"value": "22609"
},
"timeRange": {
"months": "3"
}
}
}
],
"dataUrl": "example.com",
"contributingSubdomains": [
{
"contributingSubdomain":{
"reach":{
"percentage":"4.1%"
},
"pageViews":{
"perUser":"101.2",
"percentage":"76.6%"
},
"timeRange":{
"months":"1"
},
"dataUrl":"hs.example.net"
}
},
{
"contributingSubdomain":{
"reach":{
"percentage":"64.9%"
},
"pageViews":{
"perUser":"1.3",
"percentage":"15.7%"
},
"timeRange":{
"months":"1"
},
"dataUrl":"example.com"
}
}
],
"type":"canonical"
},
"related":{
"relatedLinks":[
{
"relatedLink":{
"title":"World Wide Web Consortium",
"navigableUrl":"http:\/\/www.w3.org\/",
"dataUrl":"www.w3.org\/","type":"canonical",
"type":"canonical"
}
},
{
"relatedLink":{
"title":"Test Central",
"navigableUrl":"http:\/\/www.test.com\/",
"dataUrl":"www.test.com\/",
"type":"canonical"
}
}
],
"dataUrl":"example.com",
"type":"canonical"
}
}
}
}
XML
Request
GET /encrypted-area HTTP/1.1
Host: api.domainapi.com/v1/info/xml/example.com
Authorization: Basic YWtpcmF0ZXN0OmR0d3N0ZXN0
Response
Response (voluntarily incomplete due to the real response's size) :
<?xml version="1.0" encoding="UTF-8"?></span>
<span class="ta"><response>
<service>info</service>
<domain>example.com</domain>
<timestamp>1234567890</timestamp>
<content>
<info>
<contentData>
<keywords />
<ownedDomains />
<adultContent>no</adultContent>
<dataUrl>example.com</dataUrl>
<speed>
<percentile>97</percentile>
<medianLoadTime>344</medianLoadTime>
</speed>
<language>
<locale>en</locale>
</language>
<linksInCount>20164</linksInCount>
<siteData>
<title>Internet Assigned Numbers Authority</title>
<onlineSince>14-Aug-1995</onlineSince>
</siteData>
</contentData>
<trafficData>
<rankByCountry>
<country>
<rank>24810</rank>
<contribution>
<users>20.4%</users>
<pageViews>28.9%</pageViews>
</contribution>
<code>US</code>
</country>
<country>
<rank>15544</rank>
<contribution>
<users>15.8%</users>
<pageViews>8.9%</pageViews>
</contribution>
<code>DE</code>
</country>
<country>
<rank>27088</rank>
<contribution>
<users>8.8%</users>
<pageViews>4.7%</pageViews>
</contribution>
<code>IN</code>
</country>
</rankByCountry>
<rank>22609</rank>
<usageStatistics>
<usageStatistic>
<reach>
<rank>
<delta>-5777</delta>
<value>18473</value>
</rank>
<perMillion>
<delta>+33%</delta>
<value>57</value>
</perMillion>
</reach>
<pageViews>
<perUser>
<delta>-29%</delta>
<value>1.69</value>
</perUser>
<rank>
<delta>2800</delta>
<value>46625</value>
</rank>
<perMillion>
<delta>-5%</delta>
<value>1.35</value>
</perMillion>
</pageViews>
<rank>
<delta>-3914</delta>
<value>23171</value>
</rank>
<timeRange>
<months>3</months>
</timeRange>
</usageStatistic>
</usageStatistics>
<dataUrl>example.com</dataUrl>
<contributingSubdomains>
<contributingSubdomain>
<reach>
<percentage>4.1%</percentage>
</reach>
<pageViews>
<perUser>101.2</perUser>
<percentage>76.6%</percentage>
</pageViews>
<timeRange>
<months>1</months>
</timeRange>
<dataUrl>hs.example.net</dataUrl>
</contributingSubdomain>
<contributingSubdomain>
<reach>
<percentage>64.9%</percentage>
</reach>
<pageViews>
<perUser>1.3</perUser>
<percentage>15.7%</percentage>
</pageViews>
<timeRange>
<months>1</months>
</timeRange>
<dataUrl>example.com</dataUrl>
</contributingSubdomain>
</contributingSubdomains>
<type>canonical</type>
</trafficData>
<related>
<relatedLinks>
<relatedLink>
<title>World Wide Web Consortium</title>
<navigableUrl>http://www.w3.org/</navigableUrl>
<dataUrl>www.w3.org/</dataUrl>
<type>canonical</type>
</relatedLink>
<relatedLink>
<title>Test Central</title>
<navigableUrl>http://www.test.com/</navigableUrl>
<dataUrl>www.test.com/</dataUrl>
<type>canonical</type>
</relatedLink>
</relatedLinks>
<dataUrl>example.com</dataUrl>
<type>canonical</type>
</related>
</info>
</content>
</response>