Start Your Trial

Documentation - metrics

Contains metrics about the target, such as total number of backlinks, referring pages, sitewide and non-sitewide pages, etc., that are similar to the Site Explorer Overview page with the addition of stats for total number of HTML pages, internal and external links.

Each request to metrics costs 1 row.
Each result costs 0 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.
text int − − Number of backlinks that use anchor texts.
image int − − Number of backlinks that use image as an anchor.
sitewide int − − Number of backlinks that appear in all pages of a single external website, such as in a footer or header.
not_sitewide int − − Number of backlinks in one or several external pages, but not all or the majority of pages of a single website.
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.
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.
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.

Examples

xml json

Request

http://apiv2.ahrefs.com?from=metrics&target=ahrefs.com&mode=domain&output=xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<AhrefsApiResponse>
  <metrics>
    <backlinks>
      636
    </backlinks>
    <refpages>
      518
    </refpages>
    <pages>
      1
    </pages>
    <text>
      501
    </text>
    <sitewide>
      0
    </sitewide>
    <not_sitewide>
      636
    </not_sitewide>
    <nofollow>
      131
    </nofollow>
    <dofollow>
      370
    </dofollow>
    <redirect>
      135
    </redirect>
    <gov>
      0
    </gov>
    <edu>
      0
    </edu>
    <html_pages>
      0
    </html_pages>
    <links_internal>
      0
    </links_internal>
    <links_external>
      0
    </links_external>
  </metrics>
</AhrefsApiResponse>