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