metrics_extended - Ahrefs API

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

xml json

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
  }
}