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 endpoint returns the top 500 pages in the entire index with the highest Page Authority values, sorted by Page Authority. (Visit the Top 500 Sites list to explore the top root domains on the web, sorted by Domain Authority.)

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

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


Woo! 🎉
Thanks for the feedback.

Got it.
Thanks for the feedback.