V1 Top Pages
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.seomoz.com/linkscape/top-pages/moz.com?Offset=0&Limit=3&Cols=4&Sort=page_authority&AccessID=member-cf180f7081&Expires=1225138899&Signature=LmXYcPqc%2BkapNKzHzYz2BI4SXfC%3D
Mozs Links API returns:
[{"uu":"moz.com/"},{"uu":"moz.com/blog"},{"uu":"moz.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.