refdomains_new_lost - Ahrefs API

Ahrefs API v2 has been discontinued

This documentation is for the legacy version of our API (v2), which you can no longer subscribe to. If you already have an active API v2 subscription, it will still work as before. Read about our latest API v3.

Documentation - refdomains_new_lost

Contains the new or lost referring domains and their details.

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

refdomains

Column Type Where Having Description
date date + + Date when the Ahrefs crawler was able to visit new or lost backlinks from the referring domain.
type string + + Indicates whether the backlinks from the referring domain are new or lost.
refdomain string + + Referring domain that contains at least one link to the target.
domain_rating int + Domain Rating of the referring domain.

Examples



Request

https://apiv2.ahrefs.com?from=refdomains_new_lost&target=ahrefs.com&mode=domain&limit=3&order_by=domain_rating%3Adesc&where=date%3D%222013-11-24%22%2Ctype%3D%22lost%22&output=json

Response

{
  "refdomains":[
    {
      "date":"2013-11-24",
      "type":"lost",
      "refdomain":"alloexpat.com",
      "domain_rating":63
    },
    {
      "date":"2013-11-24",
      "type":"lost",
      "refdomain":"dnslookup.fr",
      "domain_rating":54
    },
    {
      "date":"2013-11-24",
      "type":"lost",
      "refdomain":"acousticintegration.com",
      "domain_rating":49
    }
  ]
}