backlinks_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 - 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

xml json

Request

https://apiv2.ahrefs.com?from=backlinks_new_lost&target=ahrefs.com&mode=domain&limit=2&order_by=date%3Adesc%2Cahrefs_rank%3Adesc&output=xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<AhrefsApiResponse>
  <refpages>
    <refpage>
      <date>
        2013-11-07
      </date>
      <type>
        new
      </type>
      <ahrefs_rank>
        11
      </ahrefs_rank>
      <domain_rating>
        49
      </domain_rating>
      <url_from>
        http://www.aletenky.cz/letenky/Praha/Lond%C3%BDn
      </url_from>
      <url_to>
        http://ahrefs.com/serps/positions/ahrefs.com
      </url_to>
      <links_internal>
        0
      </links_internal>
      <links_external>
        1
      </links_external>
      <encoding>
        raw
      </encoding>
      <http_code>
        301
      </http_code>
      <title>
        301 Moved Permanently
      </title>
      <origin>
        fresh
      </origin>
      <first_seen>
        2013-11-07T06:48:09Z
      </first_seen>
      <last_visited>
        2013-11-07T06:48:09Z
      </last_visited>
      <prev_visited>
        1970-01-01T00:00:00Z
      </prev_visited>
      <original>
        true
      </original>
      <link_type>
        redirect
      </link_type>
      <redirect>
        301
      </redirect>
      <nofollow>
        false
      </nofollow>
      <alt>
        
      </alt>
      <anchor>
        
      </anchor>
      <text_pre>
        
      </text_pre>
      <text_post>
        
      </text_post>
    </refpage>
    <refpage>
      <date>
        2013-11-07
      </date>
      <type>
        new
      </type>
      <ahrefs_rank>
        11
      </ahrefs_rank>
      <domain_rating>
        59
      </domain_rating>
      <url_from>
        http://www.sagive.co.il/professional-library/web-marketing/yahoo-site-explorer-close/
      </url_from>
      <url_to>
        http://ahrefs.com/plans-pricing
      </url_to>
      <links_internal>
        38
      </links_internal>
      <links_external>
        26
      </links_external>
      <encoding>
        utf8
      </encoding>
      <http_code>
        200
      </http_code>
      <title>
        סופו של Yahoo Site Explorer ~ שגיב SEO
      </title>
      <origin>
        fresh
      </origin>
      <first_seen>
        2013-11-07T21:48:58Z
      </first_seen>
      <last_visited>
        2013-11-07T21:48:58Z
      </last_visited>
      <prev_visited>
        1970-01-01T00:00:00Z
      </prev_visited>
      <original>
        true
      </original>
      <link_type>
        href
      </link_type>
      <redirect>
        0
      </redirect>
      <nofollow>
        true
      </nofollow>
      <alt>
        
      </alt>
      <anchor>
        ahrefs
      </anchor>
      <text_pre>
        האלטרנטיבה השלישית היא
      </text_pre>
      <text_post>
        . שירות קצת יקר ביחס למתחרים אבל
      </text_post>
    </refpage>
  </refpages>
</AhrefsApiResponse>

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":". שירות קצת יקר ביחס למתחרים אבל"
    }
  ]
}