refdomains_new_lost_counters

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

Contains new and lost domains totals.

Each request to refdomains_new_lost_counters costs 1 row.
Each result in the response costs 1 row.
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 referring domain.
lost	int	−	+	Total number of lost referring domain.
new_total	int	−	+	Total number of new referring domain when ignoring where filter.
lost_total	int	−	+	Total number of lost referring domain when ignoring where filter.

Examples

xml json

Request

https://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=json

Response

{
  "counts":[
    {
      "date":"2013-11-24",
      "new":0,
      "lost":19,
      "new_total":28,
      "lost_total":19
    },
    {
      "date":"2013-11-23",
      "new":0,
      "lost":28,
      "new_total":28,
      "lost_total":28
    },
    {
      "date":"2013-11-22",
      "new":0,
      "lost":30,
      "new_total":36,
      "lost_total":30
    }
  ]
}