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

Contains the anchor text and the number of backlinks, referring pages and referring domains that has it.

Each request to anchors costs 1 row.
Each result in the response costs 1 row.
Using 'where' costs 5 rows.
Using 'having' costs 5 rows.

anchors

Column Type Where Having Description
anchor string + + Anchor text used in at least one backlink from the referring domain.
backlinks int + + Number of external backlinks found that are using the anchor text.
refpages int + + Number of pages found containing backlinks that are using the anchor text.
refdomain string + − Referring domain that contains at least one backlink using the anchor text.
refdomains int − + Number of referring domains that are using the anchor text when linking to the target.
first_seen date + + Least recent date when the Ahrefs crawler was able to visit the backlink that is using the anchor text.
last_visited date + + Most recent date when the Ahrefs crawler was able to visit the backlink that is using the anchor text.

stats

Column Type Where Having Description
backlinks int − − Total number of backlinks that are using the anchor.
refpages int − − Total number of referring pages that are using the anchor.

Examples



Request

https://apiv2.ahrefs.com?from=anchors&target=ahrefs.com&mode=domain&limit=2&output=json

Response

{
  "anchors": [
    {
      "anchor":"$11.99/month",
      "backlinks":2,
      "refpages":2,
      "refdomains":1,
      "first_seen":"2013-08-08T19:04:00Z",
      "last_visited":"2013-08-08T20:18:13Z"
    },
    {
      "anchor":"$79/month to $499/month",
      "backlinks":2,
      "refpages":2,
      "refdomains":2,
      "first_seen":"2013-09-28T18:18:27Z",
      "last_visited":"2013-10-03T05:23:31Z"
    }
  ],
  "stats":{
    "backlinks":2574830,
    "refpages":2560709
  }
}