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
Was this article helpful?
Yes! Amazing!
Yes! It was what I needed.
Meh. It wasn’t really what I was looking for.
No, it wasn’t helpful at all.
Thanks for the feedback.