V1 Top Pages (Legacy)
Looking for documentation for the current iteration of the Moz API? Access it here!
This guide outlines the endpoints for now archived Moz Links API endpoints. The new Moz Links API endpoints are available here.
Top Pages [Archive of V1 Endpoints]
The top-pages endpoint returns metrics for URLs on a subdomain you specify. Make top-pages calls with a GET request for a single subdomain and specify metrics to return with the Cols parameter.
The top-pages endpoint is only available with a paid API subscription- free API accounts do not have access to this endpoint.
Parameters
Sort
You can Sort top-pages results by Page Authority (page_authority) or the number of distinct root domains linking to a source URL (domains_linking_page).
The default value of Sort for top-pages is page_authority.
| Sort value | Description |
|---|---|
| page_authority | Source URLs with the most Page Authority return first. |
| domains_linking_page | The number of distinct root domains linking to a source URL. |
Limit and Offset
A maximum of 50 records can be retrieved per call. Use Offset and Limit to retrieve a maximum of 100,000 total records.
Filter
Moz Links API accepts only one Filter value for top-pages calls.
The default value of Filter for top-pages is all.
| Query Parameter | Description |
|---|---|
| all | Returns all pages |
| status200 | Returns links with an HTTP status code of 200 (OK). |
| status301 | Returns links with a 301 redirect specified |
| status302 | Returns links with a 302 redirect specified |
| status4xx | Returns links with an HTTP status code in the 400-range. |
| status5xx | Returns links with an HTTP status code in the 500-range. |
Sample Request
http://lsapi.seooutdoorsrank.com/linkscape/top-pages/outdoorsrank.com?Offset=0&Limit=3&Cols=4&Sort=page_authority&AccessID=member-cf180f7081&Expires=1225138899&Signature=LmXYcPqc%2BkapNKzHzYz2BI4SXfC%3D
Mozs Links API returns:
[{"uu":"outdoorsrank.com/"},{"uu":"outdoorsrank.com/blog"},{"uu":"outdoorsrank.com/tools"}]
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.