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 - backlinks_new_lost
Contains the new or lost backlinks and details of the referring pages.
Each request to backlinks_new_lost costs 1 row.
Each result in the response costs 0.2 rows.
Using 'where' costs 5 rows.
Using 'having' costs 5 rows.
• refpages
Column | Type | Where | Having | Description |
---|---|---|---|---|
date | date | + | + | Date the backlink was tagged as New or Lost. |
type | string | + | + | Indicates whether the backlink is New or Lost. |
ahrefs_rank | int | + | + | URL Rating of the referring page. |
domain_rating | int | + | + | Domain Rating of the referring domain. |
url_from | string | + | + | URL of the page where the backlink is found. |
url_to | string | + | + | URL of the page the backlink is pointing to. |
links_internal | int | + | + | Number of internal links found in the referring page. |
links_external | int | + | + | Number of external links found in the referring page. |
encoding | string | + | + | Character encoding of the referring page, for example "utf8" or "iso-8859-1" (Latin-1). |
http_code | int | + | + | HTTP code that was last returned for the referring page. |
title | string | + | + | Title of the referring page. |
origin | string | + | + | Either "fresh", "drop", or "recrawl". |
first_seen | date | + | + | Date when the Ahrefs crawler was able to visit the backlink for the first time. |
last_visited | date | + | + | Most recent date when the Ahrefs crawler was able to visit the backlink. |
prev_visited | date | + | + | Second to the most recent date when the Ahrefs crawler was able to visit the backlink |
original | boolean | + | + | Indicates whether the backlinks was present on the referring page when the Ahrefs crawler first visited it. |
link_type | string | + | + | Either "href", "redirect", "frame", "form", "canonical", "rss", or "alternate". |
redirect | int | + | + | For redirected links, the Redirect Code (3XX), zero otherwise. |
nofollow | boolean | + | + | Indicates whether the backlink is NoFollow. |
alt | string | + | + | Alternative text of the image backlink, if exists. |
anchor | string | + | + | Anchor text of the backlink. |
text_pre | string | + | + | Snippet before the anchor text. |
text_post | string | + | + | Snippet after the anchor text. |
Examples
Request
https://apiv2.ahrefs.com?from=backlinks_new_lost&target=ahrefs.com&mode=domain&limit=2&order_by=date%3Adesc%2Cahrefs_rank%3Adesc&output=json
Response
{ "refpages":[ { "date":"2013-11-07", "type":"new", "ahrefs_rank":11, "domain_rating":49, "url_from":"http://www.aletenky.cz/letenky/Praha/Lond%C3%BDn", "url_to":"http://ahrefs.com/serps/positions/ahrefs.com", "links_internal":0, "links_external":1, "encoding":"raw", "http_code":301, "title":"301 Moved Permanently", "origin":"fresh", "first_seen":"2013-11-07T06:48:09Z", "last_visited":"2013-11-07T06:48:09Z", "prev_visited":"1970-01-01T00:00:00Z", "original":true, "link_type":"redirect", "redirect":301, "nofollow":false, "alt":"", "anchor":"", "text_pre":"", "text_post":"" }, { "date":"2013-11-07", "type":"new", "ahrefs_rank":11, "domain_rating":59, "url_from":"http://www.sagive.co.il/professional-library/web-marketing/yahoo-site-explorer-close/", "url_to":"http://ahrefs.com/plans-pricing", "links_internal":38, "links_external":26, "encoding":"utf8", "http_code":200, "title":"סופו של Yahoo Site Explorer ~ שגיב SEO", "origin":"fresh", "first_seen":"2013-11-07T21:48:58Z", "last_visited":"2013-11-07T21:48:58Z", "prev_visited":"1970-01-01T00:00:00Z", "original":true, "link_type":"href", "redirect":0, "nofollow":true, "alt":"", "anchor":"ahrefs", "text_pre":"האלטרנטיבה השלישית היא", "text_post":". שירות קצת יקר ביחס למתחרים אבל" } ] }