V1 URL Metrics
URL Metrics [Archive of V1 Endpoints]
This guide outlines the endpoints for now archived Moz Links API endpoints. The new Moz Links API endpoints are available here.
The url-metrics endpoint returns metrics for a URL or set of URLs you specify. Use the Cols parameter to specify which metrics to return; enter the sum of the bit flag values for each metric.
For a single URL, use a GET request—the typical Moz Links format, with all information contained in the body of a single URL. Use batched calls for more than one URL.
The Moz Links API Response fields help you organize the information returned.
URL Metrics Values for Cols
The Cols parameter uses bit flags to specify which URL metrics are returned by the Moz Links API. You can specify more than one URL metric by adding bit flags together and entering the sum as the Cols value. For example, to receive both page title and canonical URL form, enter Cols=5 (1 + 4).
| URL Metric | Bit Flag | Response Field | Description | Free Access? |
|---|---|---|---|---|
| Title | 1 | ut | The title of the page, if available | yes |
| Canonical URL | 4 | uu | The canonical form of the URL | yes |
| Subdomain | 8 | ufq | The subdomain of the URL (for example, blog.moz.com) | no |
| Root Domain | 16 | upl | The root domain of the URL (for example, moz.com) | no |
| External Equity Links | 32 | ueid | The number of external equity links to the URL | yes |
| Subdomain External Links | 64 | feid | The number of external equity links to the subdomain of the URL | no |
| Root Domain External Links | 128 | peid | The number of external equity links to the root domain of the URL | no |
| Equity Links | 256 | ujid | The number of equity links (external) to the URL | no |
| Subdomains Linking
[Deprecated] | 512 | uifq | The number of subdomains with any pages linking to the URL
Please note, this field no longer returns results and is considered deprecated. | no |
| Root Domains Linking | 1024 | uipl | The number of root domains with any pages linking to the URL | no |
| Links | 2048 | uid | The number of links (external, equity or nonequity or not,) to the URL | yes |
| Subdomain, Subdomains Linking
[Deprecated] | 4096 | fid | The number of subdomains with any pages linking to the subdomain of the URL
Please note, this field no longer returns results and is considered deprecated. | no |
| Root Domain, Root Domains Linking | 8192 | pid | The number of root domains with any pages linking to the root domain of the URL | no |
| MozRank: URL [Deprecated] | 16384 | umrp umrr | The MozRank of the URL, in both the normalized 10-point score (umrp) and the raw score (umrr)
Please note, this field no longer returns results and is considered deprecated. | yes |
| MozRank: Subdomain [Deprecated] | 32768 | fmrp fmrr | The MozRank of the URL's subdomain, in both the normalized 10-point score (fmrp) and the raw score (fmrr)
Please note, this field no longer returns results and is considered deprecated. | yes |
| MozRank: Root Domain [Deprecated] | 65536 | pmrp pmrr | The MozRank of the URL's root domain, in both the normalized 10-point score (pmrp) and the raw score (pmrr) Please note, this field no longer returns results and is considered deprecated. | no |
| MozTrust [Deprecated] | 131072 | utrp utrr | The MozTrust of the URL, in both the normalized 10-point score (utrp) and the raw score (utrr)
Please note, this field no longer returns results and is considered deprecated. | no |
| MozTrust: Subdomain [Deprecated] | 262144 | ftrp ftrr | The MozTrust of the subdomain of the URL, in both the normalized 10-point score (ftrp) and the raw score (ftrr) Please note, this field no longer returns results and is considered deprecated. | no |
| MozTrust: Root Domain [Deprecated] | 524288 | ptrp ptrr | The MozTrust of the root domain of the URL, in both the normalized 10-point score (ptrp) and the raw score (ptrr) Please note, this field no longer returns results and is considered deprecated. | no |
| MozRank: External Equity [Deprecated] | 1048576 | uemrp uemrr | The fraction of the URL's MozRank derived solely from external links, in both the normalized 10-point score (uemrp) and the raw score (uemrr) Please note, this field no longer returns results and is considered deprecated. | no |
| MozRank: Subdomain, External Equity [Deprecated] | 2097152 | fejp fejr | The fraction, derived solely from external links, of the composite MozRank of all pages on the URL's subdomain, in both the normalized 10-digit score (fejp) and the raw score
Please note, this field no longer returns results and is considered deprecated. | no |
| MozRank: Root Domain, External Equity [Deprecated] | 4194304 | pejp pejr | The fraction, derived solely from external links, of the composite MozRank of all pages on the URL's root domain, in both the normalized 10-digit score (pejp) and the raw source
Please note, this field no longer returns results and is considered deprecated. | no |
| MozRank: Subdomain Combined [Deprecated] | 8388608 | pjp pjr | The combined MozRank of all pages on the root domain, in both the normalized 10-point score (pjp) and the raw score (pjr)
Please note, this field no longer returns results and is considered deprecated. | no |
| MozRank: Root Domain Combined [Deprecated] | 16777216 | fjp fjr | The combined MozRank of all pages on the subdomain, in both the normalized 10-point score (fjp) and the raw score (fjr)
Please note, this field no longer returns results and is considered deprecated. | no |
| Subdomain Spam Score
[Partially Deprecated] | 67108864 | fspsc | Returns six different columns related to the Spam Score metric:
Please note, this field is partially deprecated – of the 6 columns returned, one only 'fspsc' is supported, the other 5 are deprecated | no |
| HTTP Status Code | 536870912 | us | The HTTP status code recorded for this URL, if available | yes |
| Links to Subdomain | 4294967296 | fuid | The total number of links (including nofollow links) to the subdomain of the URL | no |
| Links to Root Domain | 8589934592 | puid | The total number of links, including nofollow links, to the root domain of the URL | no |
| Root Domains Linking to Subdomain | 17179869184 | fipl | The number of root domains with at least one link to the subdomain of the URL | no |
| Page Authority | 34359738368 | upa | A normalized 100-point score representing the likelihood of a page to rank well in search engine results | yes |
| Domain Authority | 68719476736 | pda | A normalized 100-point score representing the likelihood of a domain to rank well in search engine results | yes |
| External links | 549755813888 | ued | The number of external links to the URL, including nofollowed links | no |
| External links to subdomain | 140737488355328 | fed | The number of external links to the subdomain, including nofollowed links | no |
| External links to root domain | 2251799813685248 | ped | The number of external links to the root domain, including nofollowed links | no |
| Linking C Blocks
[Deprecated] | 36028797018963968 | pib | The number of links from the same C class IP addresses.
Please note, this field no longer returns results and is considered deprecated. | no |
| Time last crawled | 144115188075855872 | ulc | The time and date on which we last crawled the URL, returned in Unix epoch format | yes |
Sample Request
This example demonstrates how to get the canonical form of the URL moz.com/blog.
http://lsapi.seomoz.com/linkscape/url-metrics/moz.com%2fblog?Cols=4&AccessID=member-cf180f7081&Expires=1225138899&Signature=LmXYcPqc%2BkapNKzHzYz2BI4SXfC%3D
Moz Links API returns:
{"uu":"moz.com/blog"}
uu is the response field for canonical URL forms.
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.