V1 Example API Call

Moz Links API calls all share a common format and each part of the API call performs a function.

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

Makes an HTTP or HTTPS request to the host name and resource.The host name and resource for all API calls is lsapi.seomoz.com/linkscape.

Indicates which API command to call.

The specific API endpoint for the set of metrics you want to receive. The call url_metrics returns the metrics you specify using the Cols parameter for a URL you specify.

3. Target URL

Specifies a target URL to analyze.

The URL for the link you want to analyze is moz.com.

4. Parameters and values

Specifies the parameters for the call.

The ampersand & symbol separates parameters. For example: Cols=4&Limit=10. Each API reference lists which query parameters are valid for each Mozscape call.

The first parameter is Cols=4. The table of Cols values for url_metrics indicates that a Cols value of 4 returns the canonical form of the URL. The second parameter, Limit=10 limits the number of results to the first 10.

Unless you specify one of the Cols parameters (Cols, SourceCols, TargetCols), your API call may be valid but return no information.

Signs the request with your user information and authentication.

The signed authentication string is made up of three components your Access ID, Expires (a Unix timestamp for a future time at which the request will no longer be valid), and Signature (a securely encoded hash of your Access ID, Secret Key, and Expires timestamp). An ampersand & separates each parameter.

The question mark ? indicates where call parameters begin. An ampersand & separates each parameter.

Response fields label data returned by Moz Links calls. For example, in the JSON response to a call, the data labeled with "luuu" is the canonical form of the target URL. Response fields help you incorporate Moz Links data in your own applications.

For example, for this links call:

Moz API returns these response fields:

In this response, the response fields are: * lrid: the internal ID of the link * lsrc: the internal ID of the source URL * ltgt: the internal ID of the target URL * luuu: the canonical form of the target URL * uu: the canonical form of the source URL