Global Top Root Domains

What's Covered?

In this guide you’ll learn more about making API calls to the Global Top Root Domains endpoint for the Links API V2.

This documentation specifies information for Moz Links API V2. V1 of the Links API does not include a Global Top Root Domains endpoint.

What is this endpoint for?

This endpoint returns the top 500 root domains in the entire index with the highest Domain Authority values, sorted by descending Domain Authority. For each result, the API will return the Domain Authority, Spam Score, and the number of Linking Domains. This information can be helpful for understanding what the top sites in the Moz Links API index are and how your site compares to them.

(Visit the Top 500 Sites list to explore this data online, sorted by Domain Authority.)

Quick Links

Getting Started

Before making calls to the Global Top Root Domains endpoint, be sure you are set up with an Access ID and Secret Key within your Moz Account.

Just a reminder - the Links API V2 supports Basic Auth in which you are able to use your Access ID as a username and and your Secret Key as a password.

All requests and responses are structured in JSON.

Endpoint Location

When requesting global top root domains data from Links V2, be sure to use the following endpoint.

          
https://lsapi.seomoz.com/v2/global_top_root_domains
        

Request Syntax

          
{
    "limit": number,
    "next_token": "string"
}
        

Example JSON Request

          
{
    "limit": 1
}
        

Request Parameters

"limit" - Only return this many results. The default value is 25.

  • Type: number
  • Required: no
  • Valid Values: 1-50

"next_token" - If set, return the next set of results from a previous request whose 'next_token' element equals this value.

  • Type: string
  • Required: no

Response Syntax

          
{
    "results": [{
        "root_domain": "string",
        "root_domains_to_root_domain": number,
        "domain_authority": number,
        "link_propensity": number,
        "spam_score": number
    }],
    "next_token": "string"
}
        

Example JSON Response

          
{
   "results": [
       {
           "root_domain": "apple.com",
           "root_domains_to_root_domain": 5229035,
           "domain_authority": 100,
           "link_propensity": 0.01010640245,
           "spam_score": 5,
           "to_target": {
               "pages": 0,
               "nofollow_pages": 0,
               "redirect_pages": 0,
               "deleted_pages": 0
           }
       }
   ],
   "next_token": "ATHCF7RF1adC"
}
        

Response Elements

"results" - An array of top root domains in the index.

  • Type: Array of Map objects.

"next_token" - If non-empty, the number of results was limited by the 'limit' parameter, and the next set of results can be obtained by repeating the request with the 'next_token' request parameter set to this value.

  • Type: string

Limits

  • 500 results (50 per call)

Errors

See the Common Errors section for errors that are common to all endpoints.

          
Gone
Message: The next token has expired
HTTP Status code: 410
        

Example HTTP Request

          
POST /v2/global_top_root_domains
Host: lsapi.seomoz.com
Content-Length: [length of request payload in bytes]
User-Agent: [user agent string]
Authorization: Basic [credentials]
{
    "limit": 1
}
        

Example cURL Request

          
curl -d '{"limit": 1}' -X POST https://lsapi.seomoz.com/v2/global_top_root_domains -u 'access_id:secret_key'
        

Example Python Request

          
import requests
auth = (access_id, secret_key)
url = "https://lsapi.seomoz.com/v2/global_top_root_domains"
data = """{
"limit": 5
    }
request = requests.post(url, data=data, auth=auth)
        

Related Articles


Woo! 🎉
Thanks for the feedback.

Got it.
Thanks for the feedback.