Global Top Pages
What's Covered?
In this guide you’ll learn more about making API calls to the Global Top Pages 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 Pages endpoint.
What is this endpoint for?
This endpoint returns the top 500 pages in the entire index with the highest Page Authority values, sorted by descending Page Authority. For each result, the API will return a full list of URL Metrics, including the number of links and linking domains the page has. This information can be helpful for understanding what the top pages in the Moz Links API index are and how your site compares to them.
(Visit the Top 500 Sites list to explore the top root domains on the web, sorted by Domain Authority.)
Quick Links
Getting Started
Before making calls to the Global Top Pages 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 pages data from Links V2, be sure to use the following endpoint.
https://lsapi.seomoz.com/v2/global_top_pages
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": [UrlMetricsResponse],
"next_token": "string"
}
Example JSON Response
{
"results": [
{
"page": "wordpress.org/",
"subdomain": "wordpress.org",
"root_domain": "wordpress.org",
"title": "Blog Tool, Publishing Platform, and CMS — WordPress.org",
"last_crawled": "2021-03-27",
"http_code": 200,
"pages_to_page": 3290369622,
"nofollow_pages_to_page": 211099891,
"redirect_pages_to_page": 114219,
"external_pages_to_page": 3286012612,
"external_nofollow_pages_to_page": 211098560,
"external_redirect_pages_to_page": 96153,
"deleted_pages_to_page": 1305575390,
"root_domains_to_page": 8208972,
"indirect_root_domains_to_page": 368238,
"deleted_root_domains_to_page": 885545,
"nofollow_root_domains_to_page": 884127,
"pages_to_subdomain": 3854146041,
"nofollow_pages_to_subdomain": 262697115,
"redirect_pages_to_subdomain": 1751328,
"external_pages_to_subdomain": 3761378067,
"external_nofollow_pages_to_subdomain": 262165427,
"external_redirect_pages_to_subdomain": 232521,
"deleted_pages_to_subdomain": 1513609453,
"root_domains_to_subdomain": 8547784,
"deleted_root_domains_to_subdomain": 931124,
"nofollow_root_domains_to_subdomain": 912044,
"pages_to_root_domain": 5000924343,
"nofollow_pages_to_root_domain": 282289439,
"redirect_pages_to_root_domain": 2395558,
"external_pages_to_root_domain": 4768893446,
"external_indirect_pages_to_root_domain": 445965167,
"external_nofollow_pages_to_root_domain": 279788571,
"external_redirect_pages_to_root_domain": 464339,
"deleted_pages_to_root_domain": 1874311490,
"root_domains_to_root_domain": 10293943,
"indirect_root_domains_to_root_domain": 8441,
"deleted_root_domains_to_root_domain": 936911,
"nofollow_root_domains_to_root_domain": 650047,
"page_authority": 100,
"domain_authority": 98,
"link_propensity": 0.03115903027,
"spam_score": 2,
"root_domains_from_page": 11,
"nofollow_root_domains_from_page": 0,
"pages_from_page": 12,
"nofollow_pages_from_page": 0,
"root_domains_from_root_domain": 270300,
"nofollow_root_domains_from_root_domain": 253941,
"pages_from_root_domain": 1257059,
"nofollow_pages_from_root_domain": 1004664,
"pages_crawled_from_root_domain": 8674853
}
],
"next_token": "BNKsTR1H3wTv"
}
Response Elements
"results" - An array of top pages in the index.
- Type: Array of UrlMetricsResponse objects, which have the same format as each item in the 'results' array returned by the 'url_metrics' endpoint.
"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_pages
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_pages -u 'access_id:secret_key'
Example Python Request
import requests
auth = (access_id, secret_key)
url = "https://lsapi.seomoz.com/v2/global_top_pages"
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.