broken_backlinks - Ahrefs API

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 - 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":""
    }
  ]
}