Use this endpoint to return a list of the top pages on a target domain, sorted by descending page authority, linking root domains, or external linking pages.
A SiteQuery provides a target URL along with a scope to define how the query is parsed.
options
object
Options for fetching top pages.
offset
object
Limit and pagination controls. Optionally specify the total number of desired results and, after the first request has been made, access results on the next page of results.
Response
site_query
object
Represents a parsed site query.
offset
object
Represents the token to provide to get the next set of results, in addition to the token that was provided (if applicable).
options
object
Echoes back the parameters provided in the original request.
top_pages
array
page
string
The page of the target requested, after canonicalization.
subdomain
string
The subdomain of the target requested, after canonicalization.
root_domain
string
The root domain of the target requested, after canonicalization.
title
string
The title of the page seen the most recent time it has been crawled, or an empty string if the page has never been crawled.
last_crawled
string
The date the most recent time the page has been crawled in 'YYYY-MM-DD' format, or an empty string if the page has never been crawled.
http_code
number
The status code returned by the host the most recent time the page was crawled. Standard HTTP status codes (for example 200 or 404) are returned when the page was reached. Values below 100 are Moz-internal codes that describe the outcome of the crawl attempt. The most common are:
0 — The page has not been crawled yet.
1 — A network or connection error prevented the crawl.
2 — The page content could not be parsed as UTF-8.
3 — The page returned binary content.
4 — The host returned a non-standard HTTP response code.
6 — An error occurred while processing the site's robots.txt.
9 — The page carries a noindex directive.
10 — The page body was truncated at 2MB.
14 — The site's robots.txt was unavailable (4xx response).
15 — The site's robots.txt was unavailable (403 or 5xx response).
21 — The page is blocked by the site's robots.txt.
pages_to_page
number
The number of unique pages currently linking to this page. Pages that link to themselves do not contribute to this count.
nofollow_pages_to_page
number
The number of unique pages currently linking to this page with only nofollow links. Pages that link to themselves do not contribute to this count.
redirect_pages_to_page
number
The number of unique pages currently redirecting to this page. Pages that link to themselves do not contribute to this count.
external_pages_to_page
number
The number of unique pages from a different root domain currently linking to this page.
external_nofollow_pages_to_page
number
The number of unique pages from a different root domain currently linking to this page with only nofollow links.
external_redirect_pages_to_page
number
The number of unique pages from a different root domain currently redirecting to this page.
deleted_pages_to_page
number
The number of unique pages that used to link to this page, but no longer do.
root_domains_to_page
number
The number of unique root domains currently linking to this page. Links from the same root domain as the target do not contribute to this count.
indirect_root_domains_to_page
number
The number of unique root domains currently linking to this page via a redirecting page or rel-canonical link. Link chains that are entirely within the same root domain as the target do not contribute to this count.
deleted_root_domains_to_page
number
The number of unique root domains that used to link to this page, but no longer do.
nofollow_root_domains_to_page
number
The number of unique root domains currently linking to this page with only nofollow links. Links from the same root domain as the target do not contribute to this count.
pages_to_subdomain
number
The number of unique pages currently linking to this subdomain. Pages that link to themselves do not contribute to this count.
nofollow_pages_to_subdomain
number
The number of unique pages currently linking to this subdomain with only nofollow links. Pages that link to themselves do not contribute to this count.
redirect_pages_to_subdomain
number
The number of unique pages currently redirecting to this subdomain. Pages that link to themselves do not contribute to this count.
external_pages_to_subdomain
number
The number of unique pages from a different root domain currently linking to this subdomain.
external_nofollow_pages_to_subdomain
number
The number of unique pages from a different root domain currently linking to this subdomain with only nofollow links.
external_redirect_pages_to_subdomain
number
The number of unique pages from a different root domain currently redirecting to this subdomain.
deleted_pages_to_subdomain
number
The number of unique pages that used to link to this subdomain, but no longer do.
root_domains_to_subdomain
number
The number of unique root domains currently linking to this subdomain. Links from the same root domain as the target do not contribute to this count.
deleted_root_domains_to_subdomain
number
The number of unique root domains that used to link to this subdomain, but no longer do.
nofollow_root_domains_to_subdomain
number
The number of unique root domains currently linking to this subdomain with only nofollow links. Links from the same root domain as the target do not contribute to this count.
pages_to_root_domain
number
The number of unique pages currently linking to this root domain. Pages that link to themselves do not contribute to this count.
nofollow_pages_to_root_domain
number
The number of unique pages currently linking to this root domain with only nofollow links. Pages that link to themselves do not contribute to this count.
redirect_pages_to_root_domain
number
The number of unique pages currently redirecting to this root domain. Pages that link to themselves do not contribute to this count.
external_pages_to_root_domain
number
The number of unique pages from a different root domain currently linking to this root domain.
external_indirect_pages_to_root_domain
number
The number of unique pages from a different root domain currently linking to this page via a redirecting page or rel-canonical link.
external_nofollow_pages_to_root_domain
number
The number of unique pages from a different root domain currently linking to this root domain with only nofollow links.
external_redirect_pages_to_root_domain
number
The number of unique pages from a different root domain currently redirecting to this root domain.
deleted_pages_to_root_domain
number
The number of unique pages that used to link to this root domain, but no longer do.
root_domains_to_root_domain
number
The number of unique root domains currently linking to this root domain. Links from the same root domain as the target do not contribute to this count.
indirect_root_domains_to_root_domain
number
The number of unique root domains currently linking to this root domain via a redirecting page or rel-canonical link. Link chains that are entirely within the same root domain as the target do not contribute to this count.
deleted_root_domains_to_root_domain
number
The number of unique root domains that used to link to this root domain, but no longer do.
nofollow_root_domains_to_root_domain
number
The number of unique root domains currently linking to this root domain with only nofollow links. Links from the same root domain as the target do not contribute to this count.
page_authority
number
A score from 1 to 100 representing the likelihood that this page will rank well in search engine result pages.
domain_authority
number
A score from 1 to 100 representing the likelihood that this root domain will rank well in search engine result pages.
link_propensity
number
A score from 0 to 1 indicating the likelihood of the target root domain to link out to other root domains. This is currently calculated as the ratio of 'root_domains_from_root_domain' to 'pages_crawled_from_root_domain'.
spam_score
number
The spam score for the target requested, or -1 if a spam score does not exist for that target.
root_domains_from_page
number
The unique number of root domains linked to by the target page, or 0 if the page has never been crawled.
nofollow_root_domains_from_page
number
The unique number of root domains linked to by the target page using only nofollow links, or 0 if the page has never been crawled.
pages_from_page
number
The unique number of pages linked to by the target page, or 0 if the page has never been crawled.
nofollow_pages_from_page
number
The unique number of pages linked to by the target page using only nofollow links, or 0 if the page has never been crawled.
root_domains_from_root_domain
number
The unique number of root domains linked to by the target root domain, or 0 if no pages on the root domain have ever been crawled.
nofollow_root_domains_from_root_domain
number
The unique number of root domains linked to by the target root domain using only nofollow links, or 0 if no pages on the root domain have ever been crawled.
pages_from_root_domain
number
The unique number of pages linked to by the target root domain, or 0 if no pages on the root domain have ever been crawled.
nofollow_pages_from_root_domain
number
The unique number of pages linked to by the target root domain using only nofollow links, or 0 if the page has never been crawled.
pages_crawled_from_root_domain
number
The number of pages on the target root domain that have been successfully crawled (i.e., a response was received from the host, regardless of the http status code associated with that response).