V1 Links

This guide outlines the endpoints for now archived Mozscape API endpoints. The new Moz Links API endpoints are available here.

The links endpoint returns information about links between a target URL and other pages and domains. Parameters for linkslet you receive a wide array or a narrow subset of results, with multiple options for how results are sorted. Response fields help you organize the information Moz Links API returns.

The links endpoint is accessible with a free API subscription with the exception of Spam Score and Sort by Spam Score.

Parameters

A Moz API links call accepts these parameters:

• Scope indicates which links to return based on whether the target and source URLs are pages, domains, or subdomains.
• Sort: Sort links results by:
• Page Authority (page_authority)
• Domain Authority (domain_authority)
• Number of unique root domains linking to the root domain (domains_linking_domain)
• Number of unique root domains linking to the page (domains_linking_page)
• Filter excludes results unless they meet criteria you specify. You can specify more than one value by separating multiple Filter parameters with a plus symbol +.
• Limit and Offset: The default value of Limit is 25 and the maximum value is 50.
• SourceDomain excludes results unless they originate from the root domain you specify.
• TargetCols is a bit flag: a numerical value specifying which data to include about the target URL.
• SourceCols is a bit flag: a numerical value specifying which data to include about source URLs that link to the target URL.
• LinkCols is a bit flag: a numerical value specifying which data to include about the link itself (for example, if the link is nofollowed).

TargetCols and SourceCols use the same possible values for the Cols parameter.Include LinkCols, SourceCols, or TargetCols in every links call; otherwise, your call may be valid but returns no data.

Sort

The default value of Sort for links is page_authority.

Using Scope and Sort Together

Moz Links returns an error for calls that specify Scope=domain<em>to</em>* and Sort=page_authority. Moz Links also only allows sorting by page authority when results include pages.

• All Scope values permit Sort=domain_authority.
• Scope values of page_to_\* permit Sort values of domains_linking_page.
• Scope values of domain_to_\* permit Sort values of domains_linking_domain.

For links calls, Filter is additive: you can apply more than one filter to a query. Use the "plus" symbol + between criteria to specify more than one filter parameter. Filter is a true logical "and", meaning results return only if they meet all filter criteria.

There is no default value for Filter on a links call. A filter value of 302 is only compatible with Sort values of page authorityor domain authority.

When you set LinkCols to values that return Flags (for example, LinksCols=2) , Moz Link API returns a numerical value in the <code>lf</code> response code fields.. The numerical value indicates attributes of the link, as specified in the following table.

Bit field values are additive. If your API call returns a value not listed below, multiple attributes are true and their bit values are added together.

This request finds the page (Scope=page_to_page&Limit=1) pointed to moz.com/blog with the highest Page Authority (Sort=page_authority) on the microsoft.com root domain (SourceDomain=microsoft.com), showing the canonical forms of the source URL (SourceCols=4) and the target URL (TargetCols=4).

This example finds the page (Scope=page_to_page) with the highest Page Authority (Sort=page_authority) containing an internal 301 link (Filter=internal+301&Limit=1) pointing to the default page on www.google.com, returns the canonical URL for the target page (TargetCols=4), and returns the canonical URL and the HTTP status code for the source page (SourceCols=536870916).

http://lsapi.seomoz.com/linkscape/links/moz.com?Scope=page<em>to</em>page&Sort=page_authority&Filter=internal+301&Limit=1&SourceCols=536870916&TargetCols= 4&AccessID=member-cf180f7081&Expires=1225138899&Signature=LmXYcPqc%2BkapNKzHzYz2BI4SXfC%3D