Ahrefs API v2 has been deprecated
This documentation is for the legacy version of our API (v2), which was fully discontinued on November 1, 2025. All remaining API v2 integrations and apps built on it no longer have access to Ahrefs data.
To build new integrations, please use Ahrefs API v3 and the Ahrefs Connect program.
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
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
}
]
}