backlinks_new_lost - Ahrefs API

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