refdomains_new_lost - Ahrefs API

Ahrefs API v2 will stop working on March 1st, 2024

This documentation is for the legacy version of our API (v2), which has been discontinued. All active API v2 subscriptions will stop working on March 1st, 2024. Existing Integration apps will continue to work as before until further notice, but new submissions are no longer accepted.

To switch from API v2 to v3, please contact our Enterprise team. Read about 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

xml json

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