1. Help
  2. Moz API — Link Data
  3. View All Endpoint Documentation - Link Data V2
  4. Global Top Pages

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 API token within your Moz Account.

For information regarding authentication, please see our Overview & Authentication guide.

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?

Thanks for the feedback.

Contact the Help Team if you have a specific question.
Cancel

Woo! 🎉
Thanks for the feedback.

Got it.
Thanks for the feedback.