Ahrefs API v2 has been deprecated
This documentation is for the legacy version of our API (v2), which was discontinued on March 1st, 2024. Existing API v2 integration apps are not affected and continue to work as before, but new submissions are no longer accepted.
To switch to API v3, please contact our Enterprise team. Read about API v3.
Documentation - metrics_extended
Contains additional metrics about the target, such as total number of referring domains, referring class C networks and referring IP addresses.
Each request to metrics_extended costs 1 row.
Each result in the response costs 1 row.
• metrics
Column | Type | Where | Having | Description |
---|---|---|---|---|
backlinks | int | − | − | Number of external backlinks found on the referring pages that link to the target. |
refpages | int | − | − | Number of external web pages containing at least one backlink that links to the target. |
pages | int | − | − | Number of unique pages visited by the Ahrefs crawler on the target. |
valid_pages | int | − | − | Number of unique pages with non 5xx HTTP code, visited by the Ahrefs crawler on the target. |
text | int | − | − | Number of backlinks that use anchor texts. |
image | int | − | − | Number of backlinks that use image as an anchor. |
nofollow | int | − | − | Number of NoFollow backlinks that link to the target. |
dofollow | int | − | − | Number of DoFollow backlinks that link to the target. |
redirect | int | − | − | Number of redirects found that forward to the target. |
canonical | int | − | − | Number of canonical backlinks that link to the target. |
alternate | int | − | − | Number of alternate backlinks that link to the target. |
gov | int | − | − | Number of backlinks of all types (including images and NoFollow) found on web pages on governmental domains that link to the target. |
edu | int | − | − | Number of backlinks of all types (including images and NoFollow) found on web pages on educational domains that link to the target. |
rss | int | − | − | Number of RSS external links from the target. |
html_pages | int | − | − | Number of HTML pages the target link has. |
links_internal | int | − | − | Number of internal links found in the target. |
links_external | int | − | − | Number of external links found in the target. |
refdomains | int | − | − | Number of domains containing at least one backlink that links to the target. |
refclass_c | int | − | − | Number of referring class C networks that link to the target. |
refips | int | − | − | Number of distinct IP addresses under a single network that link to the target. |
linked_root_domains | int | − | − | Number of internal or external domains that are linked from the target. |
Examples
Request
https://apiv2.ahrefs.com?from=metrics_extended&target=ahrefs.com&mode=domain&output=json
Response
{ "metrics":{ "backlinks":636, "refpages":518, "pages":1, "valid_pages":1, "text":501, "image":13, "nofollow":131, "dofollow":370, "redirect":135, "canonical":3, "alternate":2, "gov":0, "edu":0, "rss":1, "html_pages":0, "links_internal":0, "links_external":0, "refdomains":86, "refclass_c":68, "refips":69, "linked_root_domains":99 } }