broken_backlinks - Ahrefs API

Documentation - broken_backlinks

Contains the broken backlinks and details of the referring pages, such as anchor and page title.

Each request to broken_backlinks costs 1 row.
Each result in the response costs 5 rows.
Using 'where' costs 5 rows.
Using 'having' costs 5 rows.

• refpages

Column	Type	Where	Having	Description
url_from	string	+	+	URL of the page where the backlink is found.
url_to	string	+	+	URL of the page the backlink is pointing to.
ahrefs_rank	int	+	+	URL Rating of the referring page.
domain_rating	int	−	+	Domain Rating of the referring domain.
ahrefs_top	int	−	+	Ahrefs Rank of the target domain.
ip_from	string	+	+	IP address of the referring page.
links_internal	int	+	+	Number of internal links found in the referring page.
links_external	int	+	+	Number of external links found in the referring page.
page_size	int	+	+	Size of the referring page, in bytes.
language	string	+	+	Language of the referring page (ISO 639-1).
encoding	string	+	+	Character encoding of the referring page, for example "utf8" or "iso-8859-1" (Latin-1).
title	string	+	+	Title of the referring page.
first_seen	date	+	+	Least recent date when the Ahrefs crawler was able to visit the backlink.
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 backlink 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.
broken_at	date	+	+	The date when the Ahrefs crawler thinks the link became broken.
url_from_first_seen	date	+	+	Least recent date when the Ahrefs crawler was able to visit the referring page with backlink.
http_code	int	+	+	The HTTP code for the Link URL.
error	string	+	+	The string indicating the nature of error (currently only "dns").

Examples

xml json

Request

https://apiv2.ahrefs.com?from=broken_backlinks&target=ahrefs.com&mode=subdomains&limit=2&order_by=broken_at%3Adesc&output=xml

Response

<?xml version="1.0" encoding="UTF-8"?>
<AhrefsApiResponse>
  <refpages>
    <refpage>
      <url_from>
        http://articulos.bodastodo.com/destinos/20111119-201139-Donde-ir-de-luna-de-miel-en-la-Republica-Dominicana
      </url_from>
      <ahrefs_rank>
        0
      </ahrefs_rank>
      <domain_rating>
        0
      </domain_rating>
      <ahrefs_top>
        0
      </ahrefs_top>
      <ip_from>
        144.76.96.182
      </ip_from>
      <links_internal>
        0
      </links_internal>
      <links_external>
        1
      </links_external>
      <page_size>
        239
      </page_size>
      <encoding>
        raw
      </encoding>
      <language>
        en
      </language>
      <title>
        302 Found
      </title>
      <url_to>
        http://www.ahrefs.com/3531625.16346367-12015409.8178502
      </url_to>
      <first_seen>
        2013-08-09T11:05:34Z
      </first_seen>
      <last_visited>
        2013-08-27T06:17:56Z
      </last_visited>
      <prev_visited>
        2013-10-25T20:33:04Z
      </prev_visited>
      <original>
        false
      </original>
      <redirect>
        302
      </redirect>
      <alt>
        
      </alt>
      <anchor>
        
      </anchor>
      <text_pre>
        
      </text_pre>
      <text_post>
        
      </text_post>
      <link_type>
        redirect
      </link_type>
      <nofollow>
        false
      </nofollow>
      <broken_at>
        2015-04-16T19:27:38Z
      </broken_at>      <url_from_first_seen>
        2015-03-12T19:17:33Z
      </url_from_first_seen>
      <http_code>
        404
      </http_code>
      <error>
        
      </error>
    </refpage>
    <refpage>
      <url_from>
        http://article-library.puntadeleste-property.com/
      </url_from>
      <ahrefs_rank>
        0
      </ahrefs_rank>
      <domain_rating>
        0
      </domain_rating>
      <ahrefs_top>
        0
      </ahrefs_top>
      <ip_from>
        178.17.172.251
      </ip_from>
      <links_internal>
        0
      </links_internal>
      <links_external>
        1
      </links_external>
      <page_size>
        239
      </page_size>
      <encoding>
        raw
      </encoding>
      <language>
        en
      </language>
      <title>
        302 Found
      </title>
      <url_to>
        http://www.ahrefs.com/922604.978175804-7853172.38164507
      </url_to>
      <first_seen>
        2013-08-11T17:05:25Z
      </first_seen>
      <last_visited>
        2013-08-26T05:36:42Z
      </last_visited>
      <prev_visited>
        2013-09-25T10:45:38Z
      </prev_visited>
      <original>
        false
      </original>
      <redirect>
        302
      </redirect>
      <alt>
        
      </alt>
      <anchor>
        
      </anchor>
      <text_pre>
        
      </text_pre>
      <text_post>
        
      </text_post>
      <link_type>
        redirect
      </link_type>
      <nofollow>
        false
      </nofollow>
      <broken_at>
        2015-04-12T07:04:18Z
      </broken_at>
      <url_from_first_seen>
        2014-01-02T02:14:22Z
      </url_from_first_seen>      <http_code>
        404
      </http_code>
      <error>
        
      </error>
    </refpage>
  </refpages>
</AhrefsApiResponse>

Request

https://apiv2.ahrefs.com?from=broken_backlinks&target=ahrefs.com&mode=subdomains&limit=2&order_by=broken_at%3Adesc&output=json

Response

{
  "refpages": [
    {
      "url_from":"http://articulos.bodastodo.com/destinos/20111119-201139-Donde-ir-de-luna-de-miel-en-la-Republica-Dominicana",
      "ahrefs_rank":0,
      "domain_rating":0,
      "ahrefs_top":0,
      "ip_from":"144.76.96.182",
      "links_internal":0,
      "links_external":1,
      "page_size":239,
      "encoding":"raw",
      "language":"en",
      "title":"302 Found",
      "url_to":"http://www.ahrefs.com/3531625.16346367-12015409.8178502",
      "first_seen":"2013-08-09T11:05:34Z",
      "last_visited":"2013-08-27T06:17:56Z",
      "prev_visited":"2013-10-25T20:33:04Z",
      "original":false,
      "redirect":302,
      "alt":"",
      "anchor":"",
      "text_pre":"",
      "text_post":"",
      "link_type":"redirect",
      "nofollow":false,
      "broken_at":"2015-04-16T19:27:38Z",
      "url_from_first_seen":"2015-03-12T19:17:33Z",
      "http_code":404,
      "error":""
    },
    {
      "url_from":"http://article-library.puntadeleste-property.com/",
      "ahrefs_rank":0,
      "domain_rating":0,
      "ahrefs_top":0,
      "ip_from":"178.17.172.251",
      "links_internal":0,
      "links_external":1,
      "page_size":239,
      "encoding":"raw",
      "language":"en",
      "title":"302 Found",
      "url_to":"http://www.ahrefs.com/922604.978175804-7853172.38164507",
      "first_seen":"2013-08-11T17:05:25Z",
      "last_visited":"2013-08-26T05:36:42Z",
      "prev_visited":"2013-09-25T10:45:38Z",
      "original":false,
      "redirect":302,
      "alt":"",
      "anchor":"",
      "text_pre":"",
      "text_post":"",
      "link_type":"redirect",
      "nofollow":false,
      "broken_at":"2015-04-12T07:04:18Z",
      "url_from_first_seen":"2014-01-02T02:14:22Z",
      "http_code":404,
      "error":""
    }
  ]
}