refdomains_new_lost_counters

refdomains_new_lost_counters - Ahrefs API

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
    }
  ]
}