Start Your Trial

Documentation - refdomains_new_lost_counters

Contains new and lost domains totals.

Each request to refdomains_new_lost_counters costs 1 row.
Each result costs 1 row.
Using 'offset' costs 5 rows.
Using 'where' costs 5 rows.
Using 'having' costs 5 rows.

• counts

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.
new int − + Total number of new backlinks found from the referring domain.
lost int − + Total number of lost backlinks found from the referring domain.
new_total int − + Total number of new backlinks found from the referring domain.
lost_total int − + Total number of lost backlinks found from the referring domain.

Examples

xml json

Request

http://apiv2.ahrefs.com?from=refdomains_new_lost_counters&target=ahrefs.com&mode=domain&limit=3&where=type%3A%22lost%22&having=date%3C%3D%222013-11-24%22&order_by=date%3Adesc&output=xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<AhrefsApiResponse>
  <counts>
    <count>
      <date>
        2013-11-24
      </date>
      <new>
        0
      </new>
      <lost>
        19
      </lost>
      <new_total>
        28
      </new_total>
      <lost_total>
        19
      </lost_total>
    </count>
    <count>
      <date>
        2013-11-23
      </date>
      <new>
        0
      </new>
      <lost>
        28
      </lost>
      <new_total>
        28
      </new_total>
      <lost_total>
        28
      </lost_total>
    </count>
    <count>
      <date>
        2013-11-22
      </date>
      <new>
        0
      </new>
      <lost>
        30
      </lost>
      <new_total>
        36
      </new_total>
      <lost_total>
        30
      </lost_total>
    </count>
  </counts>
</AhrefsApiResponse>